Webhook Events

Mention received event

A connected Instagram, Facebook or LinkedIn account was mentioned in a post, caption or comment.

When it fires

Once per mention, the first time Zernio sees it. Delivery is at most once: reconcile with GET /v1/inbox/mentions.

Instagram and Facebook arrive in real time from the platform's webhook.
LinkedIn arrives from its webhook or from polling, so delivery can take minutes. A newly connected account can receive mentions from the last 48 hours once.

Payload notes

Carries the same fields as GET /v1/inbox/mentions. Fields a platform does not provide are null. A LinkedIn mention found by polling for a team that does not retain content has no author, and an Instagram mention has no content if the live read fails.

postWebhookmention.received

Payload

idstring required

Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.

testboolean

Always true when present: only a sample sent by POST /v1/webhooks/test with an event carries it. Real deliveries never do.

event'mention.received' required

timestampstring date-time required

Example payload

{
  "profiles": [
    {
      "externalId": "tenant_42"
    }
  ]
}

Response

Webhook received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.