support.conversation.assigned

Clearing an assignment fires this same event with data.assigned_to_user_id: null. There is no separate "unassigned" event — branch on the null.

When this fires

A conversation's assignee changes: it is handed to a team member from the dashboard inbox, the REST API, Zapier, or n8n — or an existing assignment is cleared.

Required ability

support-conversation:view — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "support.conversation.assigned",
  "created_at": "2026-08-20T10:09:00Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "conversation_id": "9e042b6f-5d81-4c37-a920-7b3e18cf6d45",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "subscriber_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "assigned_to_user_id": "4b7c9d21-3e58-4f16-8a02-6d9e5c1b7f34"
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `support.conversation.assigned` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	string UUID	Project this event belongs to.
`data.conversation_id`	string UUID	The conversation whose assignee changed.
`data.project_id`	string UUID	Mirrors the envelope `project_id`.
`data.subscriber_id`	string UUID	The member the conversation belongs to.
`data.assigned_to_user_id`	string UUID / null	The team member now responsible. `null` means the assignment was cleared.

Caveats

assigned_to_user_id is a team member's user id — an account with dashboard access — not the member's subscriber_id. The two are different namespaces.
Assignment is advisory. It does not restrict who may reply; anyone on the team with support-conversation:update still can.
Re-assigning to the same person fires the event again. Deduplicate on id if you are posting notifications.

support.conversation.resolved — the usual next step once the assignee has answered.
support.message.received — what typically prompts an assignment.
Support events overview — back to family overview.