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)

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

zendesk-zen-event-type-agent-state-changed.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"
}

Key fields

Field Type Example
id string 01GX79ST1QX01C889XV42S2J5T
type string zen:event-type:agent.state_changed
account_id integer 2

Full schema: 15 fields.

Send example to Inspect → View as JSON

zen:event-type:agent.work_item_added

documented 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 Resource agent

zendesk-zen-event-type-agent-work-item-added.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"
}

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.

Send example to Inspect → View as JSON

zen:event-type:agent.work_item_updated

documented 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 Resource agent

zendesk-zen-event-type-agent-work-item-updated.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"
}

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.

Send example to Inspect → View as JSON

zen:event-type:agent.work_item_removed

documented 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 Resource agent

zendesk-zen-event-type-agent-work-item-removed.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"
}

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.

Send example to Inspect → View as JSON

zen:event-type:agent.max_capacity_changed

documented 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 Resource agent

zendesk-zen-event-type-agent-max-capacity-changed.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"
}

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.

Send example to Inspect → View as JSON

zen:event-type:agent.unified_state_changed

documented from Zendesk docs (example)

Agent's unified or custom status moves

Identified by type in the body; none on trigger or automation webhooks Resource agent

zendesk-zen-event-type-agent-unified-state-changed.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"
}

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.

Send example to Inspect → View as JSON

zen:event-type:agent.channel_created

documented from Zendesk docs (example)

Agent gains access to a channel

Identified by type in the body; none on trigger or automation webhooks Resource agent

zendesk-zen-event-type-agent-channel-created.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"
}

Key fields

Field Type Example
id string 01GX79ST1QX01C889XV42S2J5Z
type string zen:event-type:agent.channel_created
account_id integer 2

Full schema: 13 fields.

Send example to Inspect → View as JSON

zen:event-type:agent.channel_deleted

documented from Zendesk docs (example)

Agent loses access to a channel

Identified by type in the body; none on trigger or automation webhooks Resource agent

zendesk-zen-event-type-agent-channel-deleted.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"
}

Key fields

Field Type Example
id string 01GX79ST1QX01C889XV42S2J5Z
type string zen:event-type:agent.channel_deleted
account_id integer 2

Full schema: 13 fields.

Send example to Inspect → View as JSON

zen:event-type:agent.groups_updated

documented from Zendesk docs (example)

Agent's group memberships are updated

Identified by type in the body; none on trigger or automation webhooks Resource agent

zendesk-zen-event-type-agent-groups-updated.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"
}

Key fields

Field Type Example
id string 01GX79ST1QX01C889XV42S2J5T
type string zen:event-type:agent.groups_updated
account_id integer 2

Full schema: 16 fields.

Send example to Inspect → View as JSON

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.

Not affiliated with Zendesk. Facts are compiled from public sources and linked inline.