Skip to main content
POST
/
api
/
v1
/
events
/
ingest
Ingest events
curl --request POST \
  --url https://api.example.com/api/v1/events/ingest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "code": "<string>",
      "customer_id": "<string>",
      "event_id": "<string>",
      "timestamp": "2026-01-15T10:30:00Z",
      "properties": {
        "region": "us-east-1",
        "tier": "pro",
        "bytes": "1048576"
      }
    }
  ],
  "allow_backfilling": true,
  "allow_partial_failures": true
}
'
{
  "failures": [
    {
      "event_id": "<string>",
      "reason": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
events
object[]
required

1–100 events per request.

allow_backfilling
boolean | null

Allow events with timestamps more than 1 day in the past. Defaults to false.

allow_partial_failures
boolean | null

Accept the batch even if some events fail validation. Defaults to false. When true, valid events are ingested and failures are reported in the response body. When false (default), any invalid event rejects the entire batch.

Response

Events ingested successfully

failures
object[]

Events that failed to ingest. Omitted when no failures.