Skip to main content
WEBHOOK
organization.event
{
  "event": "conversation.created",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "data": {
    "id": "019a5a3c-f1ce-7066-86ae-1ed35540a7ce",
    "title": "Help with my account",
    "status": "open",
    "priority": "normal",
    "channel": "email",
    "assignee_id": null,
    "assignee_type": null,
    "customer_id": "0197d061-63a9-73c5-b574-e49d8b7964fb",
    "created_at": "2025-11-06T17:35:34+00:00",
    "updated_at": "2025-11-06T17:35:34+00:00"
  }
}

Authorizations

​
Authorization
string
header
required

Workspace API token. Include abilities external-api:read and/or external-api:write.

Body

application/json
​
event
enum<string>
required
Available options:
conversation.created,
conversation.deleted,
conversation.assigned.updated,
conversation.status.updated,
conversation.priority.updated,
conversation.tags.updated,
conversation.customer.message.created,
conversation.user.message.created,
customer.created,
customer.updated,
customer.deleted,
agent.created,
agent.updated,
agent.deleted,
training.created,
training.updated,
training.deleted,
training.agent.assigned
​
id
string<uuid>
required

Unique webhook delivery identifier

​
organization_id
string<uuid>
required

Organization UUID that emitted the event

​
data
object
required

Event-specific payload. Shape depends on event type.

Response

Acknowledge receipt