OpenAPI 3.1.02026-08-205681892.2 MB

26bee5940ef6

Webhook Events

Referral received event

Fired when someone opens an EXISTING Instagram or Messenger thread through an attributable entry point - an ig.me / m.me link with a ref parameter, or (Messenger) a returning Click-to-Message ad click - which Meta delivers as a standalone referral with no message attached. A referral that rides an inbound message (first message of a thread, icebreaker taps, returning ad clicks on Instagram) arrives on message.received under metadata.referral instead; the two never fire for the same click. The first referral captured on a conversation is also persisted on it (see metadata on GET /v1/inbox/conversations). Requires the Inbox add-on.

postWebhookreferral.received

Payload

idstring required

Stable webhook event ID

event'referral.received' required
timestampstring date-time required

UTC time at which Zernio generated this event (set once when the event payload is built, before delivery is queued). Retries and redeliveries keep the original value, so it reflects the event, not the delivery attempt.

Response

Webhook received successfully