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