v4

latestOpenAPI 3.1.02026-08-0461143156.1 KB
events

Ingest Event

Ingest a first-party event.

Every well-formed event is accepted and stored, whether or not its subject can be correlated to a known contact or company: correlation is best-effort and runs asynchronously. Replaying the same external_event_id (or the exact same event content) is idempotent: the event is accepted but never stored or processed twice.

Requires the events:write scope on the API key.

post/v1/events

Request body

event_namestring required

Custom event name (1–255 characters).

occurred_atstring date-time required

RFC 3339 timestamp when the event occurred.

external_event_idstring nullable

Optional stable identifier from the caller's system, used for idempotent replays.

payloadobject nullable

Free-form JSON attributes for the event.

Response

Successful Response

acceptedboolean required

Whether the event was accepted for processing.

idempotency_keystring required

Key under which the event was deduplicated.