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