Skip to main content
POST
Ingest a batch of events

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

x-orbit-cdp-signature
string
required

HMAC-SHA256 of the raw request body, keyed by the tenant ingest secret.

x-orbit-cdp-timestamp
string
required

Unix-epoch seconds the payload was signed; rejected outside the replay window.

x-orbit-cdp-nonce
string
required

Unique per-request nonce used to reject replays.

Path Parameters

ingest_id
string
required

Public, tenant-bound ingest identifier from your CDP source config.

Body

application/json
batch
object[]
required
Required array length: 1 - 200 elements
sentAt
string<date-time>

Response

200 - application/json

Batch processed. count is the number of events handled and results carries the per-event outcome — ok / received split out a tombstone-drop from a success, with event_id, contact_id, reason and error per element.

data
object
meta
object