Batch Events

Request Body

application/json

A token plus an array of /track-compatible events.

TypeScript Definitions

Use the request body type in TypeScript.

token*string

The token for your Source. You can find this in the dashboard.

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    }  ]}

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

{  "success": false,  "error": "string"}

{  "success": false,  "error": "string"}

{  "success": false,  "error": "string",  "limit": 0}

{  "success": false,  "error": "string"}

{  "success": false,  "error": "string",  "retryable": true,  "results": [    {      "index": 0,      "success": false,      "code": "invalid_event",      "message": "string"    }  ]}

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`