Track a batch of events

Records multiple events in one request and returns a collector response for each, in order.

This endpoint expects a list of objects.

event_idstringRequired

Unique event ID (ULID)

event_namestringRequired

Event name (page_view, order_completed, etc.)

event_timedoubleRequired

Event timestamp (Unix seconds)

anonymous_idstringRequired

Anonymous visitor ID

schema_version"1"OptionalDefaults to 1

Schema version

user_idstring or nullOptional

Known user ID after identify

traitsobject or nullOptional

User traits (email, phone, etc.)

contextobject or nullOptional

Event context.

propertiesmap from strings to any or nullOptional

Event properties

test_modebooleanOptionalDefaults to false

Whether event is in test mode

Successful Response

okbooleanDefaults to true

event_idstring or null

duplicatebooleanDefaults to false

422

Unprocessable Entity Error

$	curl -X POST https://host.com/batch \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"event_id": "string",
>	"event_name": "string",
>	"event_time": 1.1,
>	"anonymous_id": "string"
>	}
>	]'