Batch Events

Request Body

application/json

A token plus an array of /track-compatible events. The schema describes canonical JSON inputs. The server also accepts values normalized by the preprocessing described on individual fields.

TypeScript Definitions

Use the request body type in TypeScript.

token*string

The token for your Source. You can find this in the dashboard. Leading and trailing whitespace is removed before validation.

Match\S

Length1 <= length <= 250

events*array<>

A list of /track-shaped events to validate and enqueue together.

Items1 <= items <= 1000

Response Body

`application/json`

curl -X POST "https://example.com/batch" \  -H "Content-Type: application/json" \  -d '{    "token": "string",    "events": [      {        "event": "string",        "distinctId": "string"      }    ]  }'

{  "success": true,  "accepted": 0,  "failed": 0,  "results": [    {      "index": 0,      "success": true    }  ]}

Batch Events

Request Body

Response Body

200application/json

207application/json

400application/json

401application/json

413application/json

415application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`