conversation.assigned▾

conversation.assigned

A thread was assigned to an agent, or returned to the queue.

Fires on assignment from the inbox, from update a conversation, or from an automation rule. assignee is null when a thread goes back to the unassigned queue.

EVENTconversation.assigned
Payload
{
  "id": "evt_01JZQ6F5H7K9M1P3R5T7V9XZBD",
  "object": "event",
  "type": "conversation.assigned",
  "created_at": "2026-09-06T09:41:02.114Z",
  "api_version": "2026-09-01",
  "data": {
    "object": "conversation",
    "id": "conv_01JZQ3F8X0QG7T2S4N8V1PZAKD",
    "contact": { "wa_id": "201005550123", "name": "Nadia Haddad" },
    "assignee": { "id": "usr_01JZQ0A1", "name": "Amina R.", "email": "amina@example.com" },
    "previous_assignee": null,
    "assigned_by": "automation",
    "status_at": "2026-09-06T09:42:00.000Z"
  }
}

Notable fields

assigneeobject

The agent now responsible, or null for the queue.

assigned_byenumrequired

What performed the assignment.

userapiautomation

Previousnumber.quality_updatedNextChannels