# mention.received

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.




**Payload for `mention.received`:**

- **id** (required) `string`: 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.
- **profiles**: `WebhookProfiles` - See schema definition
- **test** `boolean`: Always true when present: only a sample sent by POST /v1/webhooks/test with an event carries it. Real deliveries never do.
- **event** (required) `string`: No description - one of: mention.received
- **mention** (required) `object`: 
  - **id** (required) `string`: Mention ID, the same as `id` on GET /v1/inbox/mentions.
  - **platform** (required) `string`: No description - one of: instagram, facebook, linkedin
  - **type** (required) `string,null`: Null on LinkedIn. - one of: caption, post, comment, 
  - **mediaId** (required) `string,null`: Instagram media ID.
  - **postId** (required) `string,null`: Facebook post ID.
  - **commentId** (required) `string,null`: No description
  - **content** (required) `string,null`: Text that mentioned the account.
  - **permalink** (required) `string,null`: URL to the source post on LinkedIn. Null on Instagram and Facebook.
  - **authorUrn** (required) `string,null`: No description
  - **authorName** (required) `string,null`: No description
  - **authorUsername** (required) `string,null`: No description
  - **authorPicture** (required) `string,null`: No description
  - **organizationalEntity** (required) `string`: The mentioned organization, Page or Instagram account.
  - **publishedAt** (required) `string` (date-time): No description
- **account** (required) `object`: 
  - **id** (required) `string`: No description
  - **accountId** `string`: SocialAccount id, the same as `id`.
  - **platform** (required) `string`: No description
  - **username** (required) `string`: No description
- **timestamp** (required) `string` (date-time): No description