Skip to main content
POST
Submit a conversion event

Authorizations

Authorization
string
header
required

Per-tracker bearer secret. It authenticates only the Signal tracker represented by the credential.

Headers

Idempotency-Key
string

Optional idempotency key. When event_id is omitted, PlainRouter uses this value as event_id. If both are supplied, they must match.

Body

application/json
event_name
string
required

Signal event name; maximum 100 characters.

Legal basis for processing. Legitimate-interest revenue lifecycle events are rejected; use an authenticated server adapter.

Allowed value: "consent"
event_id
string

Caller-supplied idempotency key; maximum 128 characters.

parent_event_id
string

Optional parent event id; maximum 128 characters.

event_time

Unix timestamp or ISO-8601 date-time. Defaults to receipt time.

event_source
string<uri>

Optional absolute source URL.

action_source
string

Optional action source; defaults to website and is limited to 50 characters.

visitor_id
string

Optional visitor identifier; maximum 255 characters.

Consent state supplied with the event.

Consent Mode v2 signal values supplied with the event.

tcf
object

TCF v2 data containing string and optional captured_at.

user_data
object

Identity fields accepted by the tracker.

click_ids
object

Advertising click identifiers.

value_data
object

Optional commerce data. Contents accepts at most 50 items and 16 KB serialized.

Response

Duplicate event accepted idempotently.

event_id
string
required
duplicate
boolean
required