Webhook events · conversations
conversation.mention.created/1
Staff member mentioned. A staff member was @-mentioned in a conversation (in the app, or by a note with mentions through the API). One event per person mentioned. The note text is not included.
Payload
We POST this JSON to your endpoint. Answer any 2xx within 30 seconds. The same id arrives again on a retry — skip ones you have handled.
| Field | Type | What it is |
|---|---|---|
| idrequired | string | Event id. The same on every retry: use it to skip duplicates.pattern ^evt_[0-9A-HJKMNP-TV-Z]{26}$ |
| typerequired | string | Event type.always conversation.mention.created |
| versionrequired | string | Payload version.always 1 |
| api_versionrequired | string | The endpoint's API version. |
| occurred_atrequired | string | When it happened.date-time |
| company_idrequired | integer | Your workspace id. |
| datarequired | object | |
| idrequired | integer | Mention id. |
| conversationrequired | object | |
| idrequired | integer | Conversation id. |
| company_idrequired | integer | Workspace id. |
| by_staff | object or null | Who mentioned them. |
| idrequired | integer | Id. |
| namerequired | string or null | Name. |
| mentioned_staffrequired | object or null | Who was mentioned. |
| idrequired | integer | Id. |
| namerequired | string or null | Name. |
| acknowledged_at | string or null | ISO 8601; null until they acknowledge it. |
Example
{
"id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
"type": "conversation.mention.created",
"version": "1",
"api_version": "2026-10-01",
"occurred_at": "2026-09-24T09:20:00Z",
"company_id": 1001,
"data": {
"id": 778899,
"conversation": {
"id": 77410,
"company_id": 1001
},
"by_staff": {
"id": 1204,
"name": "Daniel Park"
},
"mentioned_staff": {
"id": 1203,
"name": "Priya Nair"
},
"acknowledged_at": null
}
}Headers
Webhook-Signature:t=…,v1=…— how to check itWebhook-Id(alsoWebhook-Event-Id): the event id, the same on every retry — skip ones you have handledWebhook-Delivery-Id: this delivery attempt, new on every try