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)

New user is added

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

zendesk-zen-event-type-user-created.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.alias_changed

documented from Zendesk docs (example)

User's alias is updated

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

zendesk-zen-event-type-user-alias-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.custom_field_changed

documented from Zendesk docs (example)

Agent edits a custom user field

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

zendesk-zen-event-type-user-custom-field-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.custom_role_changed

documented from Zendesk docs (example)

User moves to a different custom role

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

zendesk-zen-event-type-user-custom-role-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.default_group_changed

documented from Zendesk docs (example)

User moves to a different default group

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

zendesk-zen-event-type-user-default-group-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.details_changed

documented from Zendesk docs (example)

Details on a user's profile are edited

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

zendesk-zen-event-type-user-details-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.external_id_changed

documented from Zendesk docs (example)

User gets a different external id

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

zendesk-zen-event-type-user-external-id-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.group_membership_created

documented from Zendesk docs (example)

User joins a group

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

zendesk-zen-event-type-user-group-membership-created.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.group_membership_deleted

documented from Zendesk docs (example)

User leaves a group

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

zendesk-zen-event-type-user-group-membership-deleted.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.identity_changed

documented from Zendesk docs (example)

Identity on a user, such as an email, is edited

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

zendesk-zen-event-type-user-identity-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.identity_created

documented from Zendesk docs (example)

User gains an identity, such as an email address

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

zendesk-zen-event-type-user-identity-created.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.identity_deleted

documented from Zendesk docs (example)

Identity is removed from a user

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

zendesk-zen-event-type-user-identity-deleted.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.active_changed

documented from Zendesk docs (example)

User becomes active or inactive

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

zendesk-zen-event-type-user-active-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.last_login_changed

documented from Zendesk docs (example)

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

zendesk-zen-event-type-user-last-login-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.merged

documented from Zendesk docs (example)

One user is merged into another

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

zendesk-zen-event-type-user-merged.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.name_changed

documented from Zendesk docs (example)

User is renamed

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

zendesk-zen-event-type-user-name-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.notes_changed

documented from Zendesk docs (example)

Notes on a user's profile are edited

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

zendesk-zen-event-type-user-notes-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.only_private_comments_changed

documented from Zendesk docs (example)

User is allowed or barred from commenting publicly

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

zendesk-zen-event-type-user-only-private-comments-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.organization_membership_created

documented from Zendesk docs (example)

User joins an organization

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

zendesk-zen-event-type-user-organization-membership-created.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.organization_membership_deleted

documented from Zendesk docs (example)

User leaves an organization

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

zendesk-zen-event-type-user-organization-membership-deleted.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.password_changed

documented from Zendesk docs (example)

User gets a new password

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

zendesk-zen-event-type-user-password-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.photo_changed

documented from Zendesk docs (example)

User's profile photo is replaced

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

zendesk-zen-event-type-user-photo-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.role_changed

documented from Zendesk docs (example)

User moves to a different role

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

zendesk-zen-event-type-user-role-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.deleted

documented from Zendesk docs (example)

User is removed

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

zendesk-zen-event-type-user-deleted.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.suspended_changed

documented from Zendesk docs (example)

User is suspended or unsuspended

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

zendesk-zen-event-type-user-suspended-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.tags_changed

documented from Zendesk docs (example)

User's tags are updated

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

zendesk-zen-event-type-user-tags-changed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:user.time_zone_changed

documented from Zendesk docs (example)

User's time zone setting is updated

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

zendesk-zen-event-type-user-time-zone-changed.json
{
  "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.

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.