# 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`. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/zendesk/mcp-events).

These pages list the events a webhook subscribed to Zendesk events receives. A webhook connected to a [trigger or automation](https://developer.zendesk.com/documentation/webhooks/creating-and-monitoring-webhooks/#connecting-a-webhook-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](https://developer.zendesk.com/api-reference/integration-services/inbound-webhooks/inbound_webhooks/).

Agent skill: `npx skills add hookdeck/webhook-skills --skill zendesk-webhooks` ([details](https://hookdeck.com/webhooks/zendesk/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Zendesk's official docs](https://developer.zendesk.com/api-reference/event-connectors/webhooks/webhook-event-types/).

[Overview](https://hookdeck.com/webhooks/zendesk) · [Webhook events (142)](https://hookdeck.com/webhooks/zendesk/events) · [MCP events](https://hookdeck.com/webhooks/zendesk/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/zendesk/verify) · [Production guide](https://hookdeck.com/webhooks/zendesk/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/zendesk/skill)

## zen:event-type:agent.state_changed

Confidence: documented · Schema: from Zendesk docs (example)

Agent's status on one channel moves to online, offline or away

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-state-changed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5T` |
| `type` | string | `zen:event-type:agent.state_changed` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-state-changed.json)

## zen:event-type:agent.work_item_added

Confidence: documented · Schema: from Zendesk docs (example)

Ticket, conversation or call is assigned to an agent

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-work-item-added.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.work_item_added` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-work-item-added.json)

## zen:event-type:agent.work_item_updated

Confidence: documented · Schema: from Zendesk docs (example)

Item in an agent's assigned work is updated

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-work-item-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.work_item_updated` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-work-item-updated.json)

## zen:event-type:agent.work_item_removed

Confidence: documented · Schema: from Zendesk docs (example)

Item is taken out of an agent's assigned work

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-work-item-removed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.work_item_removed` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-work-item-removed.json)

## zen:event-type:agent.max_capacity_changed

Confidence: documented · Schema: from Zendesk docs (example)

Agent's per-channel limit on work items is updated

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-max-capacity-changed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.max_capacity_changed` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-max-capacity-changed.json)

## zen:event-type:agent.unified_state_changed

Confidence: documented · Schema: from Zendesk docs (example)

Agent's unified or custom status moves

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-unified-state-changed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.unified_state_changed` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-unified-state-changed.json)

## zen:event-type:agent.channel_created

Confidence: documented · Schema: from Zendesk docs (example)

Agent gains access to a channel

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-channel-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.channel_created` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-channel-created.json)

## zen:event-type:agent.channel_deleted

Confidence: documented · Schema: from Zendesk docs (example)

Agent loses access to a channel

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-channel-deleted.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5Z` |
| `type` | string | `zen:event-type:agent.channel_deleted` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-channel-deleted.json)

## zen:event-type:agent.groups_updated

Confidence: documented · Schema: from Zendesk docs (example)

Agent's group memberships are updated

Identified by: type in the body; none on trigger or automation webhooks · Object: `agent`

```json
{
  "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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-groups-updated.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5T` |
| `type` | string | `zen:event-type:agent.groups_updated` |
| `account_id` | integer | `2` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-agent-groups-updated.json)

---

Not affiliated with Zendesk. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/zendesk.json) · [Report a correction](https://hookdeck.com/contact)
