Skip to content

POST Send batch of tracking events (up to 100 events per request)

POST /viewers/{viewerToken}/tracking-event/batch: Send batch of tracking events (up to 100 events per request). Efficiently track multiple visitor events in a

POSThttps://api.rooom.com/viewers/{viewerToken}/tracking-event/batch
Try it out

Parameters

Path Parameters

NameTypeDescription
viewerTokenrequired
Example: _viewerToken_
stringViewer token.

Body required

application/json
NameTypeDescription
sessionIdrequired
Example: sess_abc123xyz
stringViewer session token for tracking user activity
eventsrequiredarrayArray of event objects using the event key and optional payload format (maximum 100 events per request)

Responses

200All events successfully logged
207Partial success - Some events logged, some failed validation
400Bad Request - Invalid request format, empty events array, or all events invalid
POST /viewers/{viewerToken}/tracking-event/batch Send batch of tracking events (up to 100 events per request) Efficiently track multiple visitor events in a single request. Supports partial success with detailed error reporting for invalid events. Public endpoint - no authentication required. viewerToken Viewer token. sessionId Viewer session token for tracking user activity events Array of event objects using the event key and optional payload format (maximum 100 events per request)