v1

latestOpenAPI 3.0.12026-07-244011,5573.5 MB

Events

Submit an event asynchronously

Submits a consumer event asynchronously. No per-request rate limit - use for high-volume or bulk integrations. May return 429 only if the downstream ingestion queue is saturated. Only event_id is returned; person identification occurs asynchronously after the request returns.

post/v6/async-events

Request body

event_namestring required

Name of the event being submitted (for example, conversion or registration). Required.

event_timestring required

ISO 8601 timestamp of when the event occurred. Optional; defaults to the time the request is received. Use for backdated events.

Example request

{
  "data": {
    "email": "user@example.com",
    "event_time": "2024-01-15T12:00:00Z",
    "partner_user_id": "usr_8392047156",
    "person_id": 7465313346145957000
  }
}

Response

Event accepted and queued for asynchronous processing. Returns the assigned event_id. Person identification completes after the response is returned.

event_idstring required

Unique identifier for the queued event. Person identification occurs asynchronously after the request returns.