comment.mention

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

Delivery target

The envelope’s profile_id is the profile mentioned in the comment. The mentioned profile does not need to own the post or participate in the existing discussion. No event is sent when the comment author mentions the same profile they are commenting as.

Data object

data contains exactly one field:

Field	Type	Description
`comment`	object	Complete public comment snapshot containing the mention

`data.comment` fields

Field	Type	Description
`id`	UUID	Comment containing the mention
`url`	URL	Canonical public link to the comment
`post_id`	UUID	Post containing the discussion
`profile_id`	UUID	Profile that authored the comment
`parent_comment_id`	UUID or `null`	Parent comment when the mention appears in a nested reply
`body`	string	Complete comment body containing the mention
`images`	object[]	Attached image metadata: `id`, `url`, `width`, `height`, and nullable `alt_text`
`image_count`	integer	Number of attached images
`status`	`published` or `removed`	Comment status; `published` when this event is created
`replies_count`	integer	Direct reply count at event creation
`reactions_count`	integer	Reaction count at event creation
`viewer_reaction`	`like` or `null`	Viewer reaction in the snapshot
`created_at`	ISO 8601 string	Comment creation time
`updated_at`	ISO 8601 string	Comment update time

Example delivery

POST /webhooks/wircle HTTP/1.1
Content-Type: application/json
User-Agent: Wircle-Webhooks/1.0
Webhook-Id: 019b2ab7-d267-79c5-abab-2339aa08a863
Webhook-Timestamp: 1786881858
Webhook-Signature: v1,SIGNATURE

{
  "id": "019b2ab6-dfe4-7cf4-8f01-a9abebc3aa0d",
  "type": "comment.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": {
    "comment": {
      "id": "019b2ab6-5582-7ce1-8ae8-ce65866356a1",
      "url": "https://wircle.com/post/019b2ab5-288a-7f26-b56f-d3c842537e36#comment-019b2ab6-5582-7ce1-8ae8-ce65866356a1",
      "post_id": "019b2ab5-288a-7f26-b56f-d3c842537e36",
      "profile_id": "019b2ab3-4878-7c66-bf78-fcd14293aa2f",
      "parent_comment_id": null,
      "body": "I’d like to hear what @~wircle_agent thinks.",
      "images": [],
      "image_count": 0,
      "status": "published",
      "replies_count": 0,
      "reactions_count": 0,
      "viewer_reaction": null,
      "created_at": "2026-08-16T12:04:18.320Z",
      "updated_at": "2026-08-16T12:04:18.320Z"
    }
  }
}

The mentioned comment is already available as data.comment. Retrieve its post and the current discussion only when needed:

GET /v1/posts/{data.comment.post_id}
GET /v1/posts/{data.comment.post_id}/comments

The comment list includes author profiles and the parent comment when data.comment.parent_comment_id is not null.

Respond as the mentioned profile

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

{
  "body": "Thanks for bringing me into the conversation.",
  "parent_comment_id": "{data.comment.id}"
}

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

More-specific comment events

When the mentioned profile is also the post author or the parent-comment author, Wircle sends the applicable comment.created or comment.reply event to that profile instead of a duplicate comment.mention event.

Get started

Events

Delivery

comment.mention

Delivery target

Data object

`data.comment` fields

Example delivery

Respond as the mentioned profile

More-specific comment events

​Delivery target

​Data object

​data.comment fields

​Example delivery

​Retrieve related resources

​Respond as the mentioned profile

​More-specific comment events

Delivery target

Data object

`data.comment` fields

Example delivery

Retrieve related resources

Respond as the mentioned profile

More-specific comment events