Zendesk agent webhook events
Zendesk sends 9 agent events, including zen:event-type:agent.state_changed, zen:event-type:agent.work_item_added and zen:event-type:agent.work_item_updated.
These pages list the events a webhook subscribed to Zendesk events receives. A webhook connected to a trigger or automation sends the request you define, a JSON or XML body or URL parameters, with no type field but the same signature headers. To send events into Zendesk instead, see ZIS inbound webhooks.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
zen:event-type:agent.state_changed
documented from Zendesk docs (example)
zen:event-type:agent.state_changed Agent's status on one channel moves to online, offline or away
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5T",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.state_changed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5T |
type | string | zen:event-type:agent.state_changed |
account_id | integer | 2 |
Full schema: 15 fields.
zen:event-type:agent.work_item_added
documented from Zendesk docs (example)
zen:event-type:agent.work_item_added Ticket, conversation or call is assigned to an agent
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.work_item_added",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.work_item_added |
account_id | integer | 2 |
Full schema: 15 fields.
zen:event-type:agent.work_item_updated
documented from Zendesk docs (example)
zen:event-type:agent.work_item_updated Item in an agent's assigned work is updated
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.work_item_updated",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.work_item_updated |
account_id | integer | 2 |
Full schema: 16 fields.
zen:event-type:agent.work_item_removed
documented from Zendesk docs (example)
zen:event-type:agent.work_item_removed Item is taken out of an agent's assigned work
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.work_item_removed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.work_item_removed |
account_id | integer | 2 |
Full schema: 15 fields.
zen:event-type:agent.max_capacity_changed
documented from Zendesk docs (example)
zen:event-type:agent.max_capacity_changed Agent's per-channel limit on work items is updated
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.max_capacity_changed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.max_capacity_changed |
account_id | integer | 2 |
Full schema: 22 fields.
zen:event-type:agent.unified_state_changed
documented from Zendesk docs (example)
zen:event-type:agent.unified_state_changed Agent's unified or custom status moves
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.unified_state_changed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.unified_state_changed |
account_id | integer | 2 |
Full schema: 20 fields.
zen:event-type:agent.channel_created
documented from Zendesk docs (example)
zen:event-type:agent.channel_created Agent gains access to a channel
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.channel_created",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.channel_created |
account_id | integer | 2 |
Full schema: 13 fields.
zen:event-type:agent.channel_deleted
documented from Zendesk docs (example)
zen:event-type:agent.channel_deleted Agent loses access to a channel
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5Z",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.channel_deleted",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5Z |
type | string | zen:event-type:agent.channel_deleted |
account_id | integer | 2 |
Full schema: 13 fields.
zen:event-type:agent.groups_updated
documented from Zendesk docs (example)
zen:event-type:agent.groups_updated Agent's group memberships are updated
Identified by type in the body; none on trigger or automation webhooks
Resource agent
{
"account_id": 2,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5T",
"subject": "zen:agent:10011",
"time": "2023-05-10T23:31:58.642630335Z",
"type": "zen:event-type:agent.groups_updated",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5T |
type | string | zen:event-type:agent.groups_updated |
account_id | integer | 2 |
Full schema: 16 fields.
Route Zendesk events by type.
Event Gateway receives every Zendesk delivery and filters and routes it by event type, so each service gets only the events it handles.