Log Custom Exposure Events

Manually logs exposure events for experiments or feature gates. Useful for analytics-only experiments, delayed exposure logging, or when automatic exposure logging is disabled.

POST /v1/log_custom_exposure

cURL

experiment_exposure

curl --request POST \ --url https://events.statsigapi.net/v1/log_custom_exposure \ --header 'Content-Type: application/json' \ --header 'statsig-api-key: <api-key>' \ --data ' { "exposures": [ { "user": { "userID": "user-123" }, "experimentName": "checkout_flow_v2", "group": "Test Group", "ruleID": "rule_abc123", "secondaryExposures": [ { "gate": "is_employee", "gateValue": "false", "ruleID": "default" } ] } ] } '

202

{
  "success": true
}

Authorizations

statsig-api-key · string · header · required

SDK API key (Server Secret or Client SDK Key)

Body

application/json

exposures · object[] · required

Array of exposure events to log

Minimum array length: 1

Option 1

Option 2

Option 3

Option 4

Show child attributes

user · object

Shared user object for all exposures

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

Exposures accepted for processing

success · boolean · required

Whether the request was successful