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

Base URL
https://events.extole.io
Auth
- API key in header Authorization
- or API key in query parameter access_token
- or API key in cookie extole_token
TypeScript
https://skmtc.dev/extole/apis/integration-api-server-to-extole/docs/v6/async-events/post.ts
A function with typed inputs. Its response is checked against the schema.

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.

Changes

No recorded changes to this operation across all 1 revision of this API.