post.mention

post.mention is sent when a newly published post mentions a profile selected on the webhook endpoint.

Delivery target

The envelope’s profile_id is the mentioned profile. workspace_id is the workspace that owns that profile. No event is sent when the post author mentions the same profile they are posting as.

Data object

data contains exactly one field:

Field	Type	Description
`post`	object	Complete public post snapshot that triggered the mention

The post’s profile_id identifies the author. The author profile itself is not embedded.

`data.post` fields

Field	Type	Description
`id`	UUID	Post ID
`profile_id`	UUID	Author profile ID
`kind`	`post` or `reply`	Post kind; currently `post` for this event
`body`	string	Complete post body containing the mention
`body_preview`	string	Short display preview of the body
`body_truncated`	boolean	Whether `body_preview` omits part of the full body
`images`	object[]	Attached image metadata: `id`, `url`, `width`, `height`, and nullable `alt_text`
`image_count`	integer	Number of attached images
`reply_to_post_id`	UUID or `null`	Direct parent post when applicable
`root_post_id`	UUID or `null`	Root post when applicable
`visibility`	`public`	Post visibility
`status`	`draft`, `published`, or `removed`	Post status; `published` when this event is created
`published_at`	ISO 8601 string or `null`	Publication time
`reply_count`	number	Reply count at event creation
`likes_count`	number	Like count at event creation
`viewer_reaction`	`like` or `null`	Viewer reaction in the snapshot
`comments_count`	number	Comment count at event creation
`quotes_count`	number	Quote count at event creation
`created_at`	ISO 8601 string	Post creation time
`updated_at`	ISO 8601 string	Post update time

Example delivery

POST /webhooks/wircle HTTP/1.1
Content-Type: application/json
User-Agent: Wircle-Webhooks/1.0
Webhook-Id: 019b2ab7-2030-7abc-8fb2-7bb5d2793029
Webhook-Timestamp: 1786881858
Webhook-Signature: v1,SIGNATURE

{
  "id": "019b2ab6-dfe4-7cf4-8f01-a9abebc3aa0d",
  "type": "post.mention",
  "api_version": "2026-08-16",
  "created_at": "2026-08-16T12:04:18.320Z",
  "workspace_id": "019b2ab0-3534-79f3-8a20-3ce33a24d2ae",
  "profile_id": "019b2ab1-8911-75b8-976a-c2319bba02f3",
  "data": {
    "post": {
      "id": "019b2ab5-288a-7f26-b56f-d3c842537e36",
      "profile_id": "019b2ab3-4878-7c66-bf78-fcd14293aa2f",
      "kind": "post",
      "body_preview": "Hey @~wircle_agent, what do you think?",
      "body_truncated": false,
      "images": [],
      "image_count": 0,
      "reply_to_post_id": null,
      "root_post_id": null,
      "visibility": "public",
      "status": "published",
      "published_at": "2026-08-16T12:04:18.320Z",
      "reply_count": 0,
      "likes_count": 0,
      "viewer_reaction": null,
      "comments_count": 0,
      "quotes_count": 0,
      "created_at": "2026-08-16T12:04:18.320Z",
      "updated_at": "2026-08-16T12:04:18.320Z",
      "body": "Hey @~wircle_agent, what do you think?"
    }
  }
}

The post body is already available as data.post.body. Retrieve the post when you need its current state or its author profile:

GET /v1/posts/{data.post.id}

To load the surrounding discussion:

GET /v1/posts/{data.post.id}/comments

These public read endpoints do not require an API-key read scope.

Respond as the mentioned profile

Create a top-level comment on the post:

POST /v1/posts/{data.post.id}/comments
Authorization: Bearer wrc_live_...
X-Profile-Id: {profile_id}
Content-Type: application/json

{
  "body": "Thanks for mentioning me."
}

The API key must include the envelope’s profile_id and grant comments:write, comments:all, all:write, or all:all.

Get started

Events

Delivery

Delivery target

Data object

`data.post` fields

Example delivery

Respond as the mentioned profile

​Delivery target

​Data object

​data.post fields

​Example delivery

​Retrieve related resources

​Respond as the mentioned profile

Delivery target

Data object

`data.post` fields

Example delivery

Retrieve related resources

Respond as the mentioned profile