conversation.assigned/1

Conversation assigned. A conversation was assigned to a staff member or a team.

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.

Payload fields
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.assigned`
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	Conversation id.
company_idrequired	integer	Workspace id.
contact	object or null	The contact.
idrequired	integer	Id.
namerequired	string or null	Name.
channel	object or null	The channel.
idrequired	integer	Id.
namerequired	string or null	Name.
assigned_staff	object or null	Assigned staff member.
idrequired	integer	Id.
namerequired	string or null	Name.
assigned_team	object or null	Assigned team.
idrequired	integer	Id.
namerequired	string or null	Name.
assigned_at	string or null	ISO 8601.
created_at	string or null	ISO 8601.
previous_staff	object or null	Who had it before.
idrequired	integer	Id.
namerequired	string or null	Name.
assignment_typerequired	string	How it was assigned.one of: `manual`, `self`, `auto`, `team`
actor	object or null	Who did it.
id	integer or null	Id.
name	string or null	Name.
typerequired	string	staff, bot, system or api.

Example

{
  "id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
  "type": "conversation.assigned",
  "version": "1",
  "api_version": "2026-10-01",
  "occurred_at": "2026-09-24T09:20:00Z",
  "company_id": 1001,
  "data": {
    "id": 77410,
    "company_id": 1001,
    "contact": {
      "id": 48213,
      "name": "Jane Doe"
    },
    "channel": {
      "id": 301,
      "name": "Main WhatsApp"
    },
    "assigned_staff": {
      "id": 1203,
      "name": "Priya Nair"
    },
    "assigned_team": null,
    "assigned_at": "2026-09-24T09:13:00Z",
    "created_at": "2026-09-24T09:11:40Z",
    "previous_staff": null,
    "assignment_type": "manual",
    "actor": {
      "id": null,
      "name": null,
      "type": "api"
    }
  }
}

Headers

Webhook-Signature: t=…,v1=… — how to check it
Webhook-Id (also Webhook-Event-Id): the event id, the same on every retry — skip ones you have handled
Webhook-Delivery-Id: this delivery attempt, new on every try

API calls that can cause it

Assign a conversation