Skip to main content
POST
Send batch of server-side events
Use the batch endpoint when you have multiple events to send — it reduces HTTP overhead and is the preferred approach for worker-based or queue-driven architectures. Use the site-scoped API key generated from your tracking site dashboard: Integrations → Conversion Tracking → API Keys. See Send Server Events for a full batch request example.

Authorizations

X-API-Key
string
header
required

Site-scoped server API key generated from Dashboard > Integrations > Conversion Tracking > Script/API > API tab

Body

application/json
events
object[]
required
Required array length: 1 - 100 elements

Response

Batch processed

success
boolean
required
accepted
integer
required
rejected
integer
required
event_ids
string<uuid>[]
required