Log Custom Events

Logs one or more custom events for analytics and metric calculation. Events are used to measure experiment outcomes and user behavior.

POST /v1/log_event

cURL

single_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"
      }
    }
  ]
}
'

202

{
  "success": true
}

Authorizations

statsig-api-key · string · header · required

SDK API key (Server Secret or Client SDK Key)

Headers

STATSIG-CLIENT-TIME · integer<int64>

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 array length: 1

Show child attributes

user · object

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

Show child attributes

statsigMetadata · object

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

Show child attributes

Example:

{
  "sdkType": "js-client",
  "sdkVersion": "4.20.0",
  "exposureLoggingDisabled": false
}

Response

202

application/json

Events accepted for processing

success · boolean · required

Whether the request was successful