---
title: "Mention received event"
method: POST
path: "mention.received"
tags: ["Webhook Events"]
---

# Mention received event

`POST mention.received` (webhook)

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

- WebhookPayloadMention: Webhook payload for mention received events (Instagram, Facebook, LinkedIn).
  - `id` string, 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.
  - `profiles` object[]: The profiles this event belongs to, each with the externalId you set on it (null when none is set). Use it to route the event to your tenant without storing Zernio profile ids. Present on every event tied to a profile, absent on events that belong to none. Events spanning several profiles (a post published to accounts of different profiles) list each once.
    - `id` string, required
    - `externalId` string, nullable, required
  - `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` 'mention.received', required
  - `mention` object, required
    - `id` string, required: Mention ID, the same as `id` on GET /v1/inbox/mentions.
    - `platform` 'instagram' | 'facebook' | 'linkedin', required
    - `type` 'caption' | 'post' | 'comment' | 'null', nullable, required: Null on LinkedIn.
    - `mediaId` string, nullable, required: Instagram media ID.
    - `postId` string, nullable, required: Facebook post ID.
    - `commentId` string, nullable, required
    - `content` string, nullable, required: Text that mentioned the account.
    - `permalink` string, nullable, required: URL to the source post on LinkedIn. Null on Instagram and Facebook.
    - `authorUrn` string, nullable, required
    - `authorName` string, nullable, required
    - `authorUsername` string, nullable, required
    - `authorPicture` string, nullable, required
    - `organizationalEntity` string, required: The mentioned organization, Page or Instagram account.
    - `publishedAt` string, date-time, required
  - `account` object, required
    - `id` string, required
    - `accountId` string: SocialAccount id, the same as `id`.
    - `platform` string, required
    - `username` string, required
  - `timestamp` string, date-time, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/a79c233ebf22?raw)