Events

Ingest a behavioral event

Records the event, applies UTM/conversion attribution and queues the automation. Provide contactId or email (at the top level of the body). With idempotencyKey (8-200 characters, e.g. the order id) the same repeated request answers 200 duplicate without recording a second event or a second conversion: a payment webhook delivered twice is the norm. Without a key every call is a new event. Required scope: events:write.

post/events

Request

  • Base URL: https://sending.dev/api/v1
  • URL: https://sending.dev/api/v1/events
  • Auth: HTTP bearer

Request body

namestring required
contactIdstring uuid
emailstring email
propertiesobject
idempotencyKeystring

Response

Same idempotencyKey already seen: nothing new recorded.

status'accepted' | 'duplicate' required
eventIdstring uuid required
contactIdstring uuid required

Changes

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