Batch
Data Pipelines
Batch
Send multiple events in a single HTTP request
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
type: "group" or type: "alias" in the batch.
Headers
HTTP Basic Auth. See Events Authentication.
Must be
application/json.Body
Array of event objects. Each item must include a
type field and the fields for that event type.When the batch was sent, as ISO 8601.
Batch item type values
| Type | Equivalent endpoint | Notes |
|---|---|---|
identify | /v1/identify | Uses traits |
track | /v1/track | Uses event + properties |
screen | /v1/screen | Uses name + properties |
page | /v1/page | Uses name + properties |
type field. Each item may also include an optional context object.
Response
Successful requests returnHTTP 200 with an empty JSON object.