inbox.thread.assigned

{
  "type": "inbox.thread.assigned",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "assignee_email": "ada@example.com",
    "assigned_by_email": "grace@example.com",
    "previous_assignee_email": null,
    "source": "dashboard",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
    "thread": {
      "object": "inbox_thread",
      "id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "subject": "Question about my invoice",
      "folder": "inbox",
      "labels": [],
      "read": false
    }
  }
}

Event triggered whenever a thread is assigned or reassigned.

Response Body Parameters

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

string

The event type that triggered the webhook (e.g., inbox.thread.assigned).

string

ISO 8601 timestamp when the webhook event was created.

object

Event-specific data containing detailed information about the event. The data object for the inbox.thread.assigned event contains the following parameters:

Hide object parameters

string | null

The email of the member the thread is now assigned to

string | null

The email of the member who made the assignment. null when no member made it

string | null

The email of the member the thread was assigned to before. null when it was unassigned

api | dashboard | agent | system

What made the change

string

The ID of the inbox

string

The ID of the thread

object

The thread, as it is when the webhook is sent. Absent when the thread no longer exists

Hide thread object

string

Always inbox_thread

string

The ID of the thread

string | null

The subject of the thread

inbox | archive | spam | sent | trash

The folder the thread lives in

array

The labels attached to the thread, each with an id, name, and color

boolean

True only when every message in the thread is read

{
  "type": "inbox.thread.assigned",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "assignee_email": "ada@example.com",
    "assigned_by_email": "grace@example.com",
    "previous_assignee_email": null,
    "source": "dashboard",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
    "thread": {
      "object": "inbox_thread",
      "id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "subject": "Question about my invoice",
      "folder": "inbox",
      "labels": [],
      "read": false
    }
  }
}

⌘I

{
  "type": "inbox.thread.assigned",
  "created_at": "2026-09-29T12:00:00.000Z",
  "data": {
    "assignee_email": "ada@example.com",
    "assigned_by_email": "grace@example.com",
    "previous_assignee_email": null,
    "source": "dashboard",
    "inbox_id": "b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1",
    "thread_id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
    "thread": {
      "object": "inbox_thread",
      "id": "7c1f0a2e-5d3b-4e8a-9f61-2b8d4c6e1a90",
      "subject": "Question about my invoice",
      "folder": "inbox",
      "labels": [],
      "read": false
    }
  }
}

Get started

Learn

Resources

inbox.thread.assigned

Response Body Parameters