Skip to main content
POST
Batch

Description

Send multiple events in a single HTTP request. SDKs queue events locally and flush them as a batch. Prefer /batch over individual calls when sending many events from a server. Short alias: POST /v1/b Limits:
  • Minimum: 1 item per batch
  • Maximum: 100 items per batch
  • Items are processed concurrently
Group and Alias are not supported. Do not include type: "group" or type: "alias" in the batch.

Headers

string
required
HTTP Basic Auth. See Events Authentication.
string
default:"application/json"
required
Must be application/json.

Body

array
required
Array of event objects. Each item must include a type field and the fields for that event type.
string
When the batch was sent, as ISO 8601.

Batch item type values

Each batch item shares the same fields as its corresponding individual endpoint, plus a type field. Each item may also include an optional context object.

Response

Successful requests return HTTP 200 with an empty JSON object.

Example request body