Event names and the version-one conversation payload delivered by ThriveDesk webhooks.
Every documented webhook uses a v1 envelope with eventType and a conversation-shaped data
object.
| Event | Trigger |
|---|---|
conversation.created | A conversation is created. |
conversation.assigned | Assignment changes. |
conversation.note.added | An internal note is added. |
conversation.agent.replied | A teammate replies. |
conversation.contact.replied | The customer replies. |
conversation.status.updated | Status changes. |
conversation.tags.updated | Tags are added or updated. |
conversation.moved | The conversation moves to another inbox. |
{
"eventType": "conversation.tags.updated",
"data": {
"type": "conversation",
"id": "dea1fca0-6529-43fd-91df-044afbf2a1d4",
"ticketId": 26,
"subject": "Order INV-1042 arrived damaged",
"excerpt": "The customer reported a cracked screen.",
"status": "Active",
"priority": "Normal",
"active": true,
"createdAt": "2026-07-29T13:04:05.000000Z",
"tags": ["Shipping", "Priority"],
"inbox": {
"id": "f86385ff-9ce5-456a-a207-0bbf4ec59c0e",
"name": "Support",
"inboxAddress": "[email protected]",
"connectedEmailAddress": "[email protected]"
},
"contact": {
"id": "925298d4-a7d9-4d6b-8a01-10b2dea439aa",
"name": "Jane Cooper",
"email": "[email protected]",
"avatar": null
},
"threadsCount": 3,
"threads": []
}
}| Field | Type | Notes |
|---|---|---|
eventType | string | One of the event names above. |
data.id | string | Stable conversation identifier; use it as the REST API ID. |
data.ticketId | integer | Human-facing ticket number. |
data.status | string | Active, Pending, or Closed. |
data.priority | string | High, Normal, or Low. |
data.inbox | object | Inbox identifiers and addresses. |
data.assignedTo | object or null | Assigned teammate. |
data.contact | object | Customer identity in ThriveDesk. |
data.threads | array | Message, note, or draft thread entries included by the event. |
Accept unknown fields and event names so additive changes do not break the receiver. When exact state matters, fetch the conversation after accepting the event.