v1

latestOpenAPI 3.0.12026-07-244011,5573.5 MB

Events

Submit an event

Submits a consumer event synchronously. Returns both event_id and person_id. Use when you need immediate confirmation that the event was processed and identity resolution has completed. For high-volume ingestion use POST /v6/async-events instead.

post/v6/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 processed. Returns the assigned event_id and the resolved Extole person_id.

event_idstring required

Unique identifier for the submitted event.

person_idstring required

Extole person ID resolved from the event data.