Skip to main content
POST
/
v1
/
log_event
curl --request POST \
  --url https://events.statsigapi.net/v1/log_event \
  --header 'Content-Type: application/json' \
  --header 'statsig-api-key: <api-key>' \
  --data '{
  "events": [
    {
      "eventName": "add_to_cart",
      "value": 29.99,
      "time": 1616826986211,
      "user": {
        "userID": "user-123"
      },
      "metadata": {
        "product_id": "prod_456",
        "category": "electronics"
      }
    }
  ]
}'
{
  "success": true
}

Authorizations

​
statsig-api-key
string
header
required

SDK API key (Server Secret or Client SDK Key)

Headers

​
STATSIG-CLIENT-TIME
integer

Client timestamp in milliseconds. Used to normalize event timestamps against server time and account for client clock drift.

Body

application/json
​
events
object[]
required

Array of events to log

Minimum length: 1
​
user
object

Shared user object for all events (can be overridden per event)

​
statsigMetadata
object

SDK metadata for tracking SDK type, version, and other diagnostic information

Example:
{
  "sdkType": "js-client",
  "sdkVersion": "4.20.0"
}

Response

Events accepted for processing

​
success
boolean
required

Whether the request was successful

⌘I