Zendesk user webhook events
Zendesk sends 27 user events, including zen:event-type:user.created. Zendesk's table spells user.identity_changed, user.identity_created and user.merged with a slash, while their example bodies use the colon shown here.
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:user.created
documented from Zendesk docs (example)
zen:event-type:user.created New user is added
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.created",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.created |
account_id | integer | 12514403 |
Full schema: 17 fields.
zen:event-type:user.alias_changed
documented from Zendesk docs (example)
zen:event-type:user.alias_changed User's alias is updated
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.alias_changed",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.alias_changed |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.custom_field_changed
documented from Zendesk docs (example)
zen:event-type:user.custom_field_changed Agent edits a custom user field
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.custom_field_changed",
"account_id": 9732064,
"id": "697bbd67-869c-4f1f-a47c-b296258c50c8",
"subject": "zen:user:6596848315901",
"time": "2099-07-07T05:10:01Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 697bbd67-869c-4f1f-a47c-b296258c50c8 |
type | string | zen:event-type:user.custom_field_changed |
account_id | integer | 9732064 |
Full schema: 24 fields.
zen:event-type:user.custom_role_changed
documented from Zendesk docs (example)
zen:event-type:user.custom_role_changed User moves to a different custom role
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.custom_role_changed",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.custom_role_changed |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.default_group_changed
documented from Zendesk docs (example)
zen:event-type:user.default_group_changed User moves to a different default group
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.default_group_changed",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.default_group_changed |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.details_changed
documented from Zendesk docs (example)
zen:event-type:user.details_changed Details on a user's profile are edited
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.details_changed",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.details_changed |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.external_id_changed
documented from Zendesk docs (example)
zen:event-type:user.external_id_changed User gets a different external id
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.external_id_changed",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.external_id_changed |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.group_membership_created
documented from Zendesk docs (example)
zen:event-type:user.group_membership_created User joins a group
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.group_membership_created",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.group_membership_created |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.group_membership_deleted
documented from Zendesk docs (example)
zen:event-type:user.group_membership_deleted User leaves a group
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.group_membership_deleted",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.group_membership_deleted |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.identity_changed
documented from Zendesk docs (example)
zen:event-type:user.identity_changed Identity on a user, such as an email, is edited
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.identity_changed",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.identity_changed |
account_id | integer | 12514403 |
Full schema: 26 fields.
zen:event-type:user.identity_created
documented from Zendesk docs (example)
zen:event-type:user.identity_created User gains an identity, such as an email address
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.identity_created",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.identity_created |
account_id | integer | 13390837 |
Full schema: 21 fields.
zen:event-type:user.identity_deleted
documented from Zendesk docs (example)
zen:event-type:user.identity_deleted Identity is removed from a user
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.identity_deleted",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.identity_deleted |
account_id | integer | 13390837 |
Full schema: 21 fields.
zen:event-type:user.active_changed
documented from Zendesk docs (example)
zen:event-type:user.active_changed User becomes active or inactive
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.active_changed",
"account_id": 12514403,
"id": "2b24ef10-19d4-4740-93cf-8f98ec4776c0",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 2b24ef10-19d4-4740-93cf-8f98ec4776c0 |
type | string | zen:event-type:user.active_changed |
account_id | integer | 12514403 |
Full schema: 18 fields.
zen:event-type:user.last_login_changed
documented from Zendesk docs (example)
zen:event-type:user.last_login_changed Last login updates, if the previous was over 20 minutes ago
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.last_login_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.last_login_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.merged
documented from Zendesk docs (example)
zen:event-type:user.merged One user is merged into another
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.merged",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.merged |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.name_changed
documented from Zendesk docs (example)
zen:event-type:user.name_changed User is renamed
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.name_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.name_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.notes_changed
documented from Zendesk docs (example)
zen:event-type:user.notes_changed Notes on a user's profile are edited
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.notes_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.notes_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.only_private_comments_changed
documented from Zendesk docs (example)
zen:event-type:user.only_private_comments_changed User is allowed or barred from commenting publicly
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.only_private_comments_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.only_private_comments_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.organization_membership_created
documented from Zendesk docs (example)
zen:event-type:user.organization_membership_created User joins an organization
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.organization_membership_created",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.organization_membership_created |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.organization_membership_deleted
documented from Zendesk docs (example)
zen:event-type:user.organization_membership_deleted User leaves an organization
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.organization_membership_deleted",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.organization_membership_deleted |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.password_changed
documented from Zendesk docs (example)
zen:event-type:user.password_changed User gets a new password
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.password_changed",
"account_id": 12514403,
"id": "ce84824c-4ba6-411f-875b-a3b0f3bcb8dd",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | ce84824c-4ba6-411f-875b-a3b0f3bcb8dd |
type | string | zen:event-type:user.password_changed |
account_id | integer | 12514403 |
Full schema: 16 fields.
zen:event-type:user.photo_changed
documented from Zendesk docs (example)
zen:event-type:user.photo_changed User's profile photo is replaced
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.photo_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.photo_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.role_changed
documented from Zendesk docs (example)
zen:event-type:user.role_changed User moves to a different role
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.role_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.role_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.deleted
documented from Zendesk docs (example)
zen:event-type:user.deleted User is removed
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.deleted",
"account_id": 12514403,
"id": "6b9bbadf-5725-4e92-bebe-7b71011bf5f1",
"subject": "zen:user:6596848315901",
"time": "2099-07-04T05:33:18Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 6b9bbadf-5725-4e92-bebe-7b71011bf5f1 |
type | string | zen:event-type:user.deleted |
account_id | integer | 12514403 |
Full schema: 16 fields.
zen:event-type:user.suspended_changed
documented from Zendesk docs (example)
zen:event-type:user.suspended_changed User is suspended or unsuspended
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.suspended_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.suspended_changed |
account_id | integer | 13390837 |
Full schema: 18 fields.
zen:event-type:user.tags_changed
documented from Zendesk docs (example)
zen:event-type:user.tags_changed User's tags are updated
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.tags_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.tags_changed |
account_id | integer | 13390837 |
Full schema: 22 fields.
zen:event-type:user.time_zone_changed
documented from Zendesk docs (example)
zen:event-type:user.time_zone_changed User's time zone setting is updated
Identified by type in the body; none on trigger or automation webhooks
Resource user
{
"type": "zen:event-type:user.time_zone_changed",
"account_id": 13390837,
"id": "40b97155-4255-4637-b4ca-c611a5b5cf68",
"subject": "zen:user:6600130024829",
"time": "2099-07-05T01:58:48Z",
"zendesk_event_version": "2022-06-20",
"detail": { … },
"event": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 40b97155-4255-4637-b4ca-c611a5b5cf68 |
type | string | zen:event-type:user.time_zone_changed |
account_id | integer | 13390837 |
Full schema: 18 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.