Zendesk organization webhook events

Zendesk sends 6 organization events, including zen:event-type:organization.created, zen:event-type:organization.custom_field_changed and zen:event-type:organization.deleted.

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:organization.created

documented from Zendesk docs (example)

New organization is added

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

zendesk-zen-event-type-organization-created.json
{
  "type": "zen:event-type:organization.created",
  "account_id": 10973248,
  "subject": "zen:organization:6607619104125",
  "id": "a540ab78-88f2-49e1-93a7-16152a6f782c",
  "time": "2099-07-07T03:44:13Z",
  "zendesk_event_version": "2022-06-20",
  "detail": { … },
  "event": { … }
}

Key fields

Field Type Example
id string a540ab78-88f2-49e1-93a7-16152a6f782c
type string zen:event-type:organization.created
account_id integer 10973248

Full schema: 16 fields.

Send example to Inspect → View as JSON

zen:event-type:organization.custom_field_changed

documented from Zendesk docs (example)

Custom organization field's value is edited

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

zendesk-zen-event-type-organization-custom-field-changed.json
{
  "type": "zen:event-type:organization.custom_field_changed",
  "subject": "zen:organization:6607817309693",
  "account_id": 9732064,
  "id": "697bbd67-869c-4f1f-a47c-b296258c50c8",
  "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:organization.custom_field_changed
account_id integer 9732064

Full schema: 24 fields.

Send example to Inspect → View as JSON

zen:event-type:organization.deleted

documented from Zendesk docs (example)

Organization is removed

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

zendesk-zen-event-type-organization-deleted.json
{
  "type": "zen:event-type:organization.deleted",
  "account_id": 10973196,
  "id": "b4fa7f87-a23a-407b-8e18-23493b6c3cb6",
  "subject": "zen:organization:6607650028541",
  "time": "2099-07-07T03:44:09Z",
  "zendesk_event_version": "2022-06-20",
  "detail": { … },
  "event": { … }
}

Key fields

Field Type Example
id string b4fa7f87-a23a-407b-8e18-23493b6c3cb6
type string zen:event-type:organization.deleted
account_id integer 10973196

Full schema: 16 fields.

Send example to Inspect → View as JSON

zen:event-type:organization.external_id_changed

documented from Zendesk docs (example)

Organization gets a different external id

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

zendesk-zen-event-type-organization-external-id-changed.json
{
  "type": "zen:event-type:organization.external_id_changed",
  "account_id": 10963496,
  "id": "87cfb1a5-26fd-436c-ad55-0ac7bb080189",
  "subject": "zen:organization:6607644529405",
  "time": "2099-07-07T03:43:54Z",
  "zendesk_event_version": "2022-06-20",
  "detail": { … },
  "event": { … }
}

Key fields

Field Type Example
id string 87cfb1a5-26fd-436c-ad55-0ac7bb080189
type string zen:event-type:organization.external_id_changed
account_id integer 10963496

Full schema: 18 fields.

Send example to Inspect → View as JSON

zen:event-type:organization.name_changed

documented from Zendesk docs (example)

Organization is renamed

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

zendesk-zen-event-type-organization-name-changed.json
{
  "type": "zen:event-type:organization.name_changed",
  "account_id": 11883297,
  "id": "3ffea334-0d99-4e78-b2bb-f0faabd20c8c",
  "subject": "zen:organization:6607649967101",
  "time": "2099-07-07T03:43:03Z",
  "zendesk_event_version": "2022-06-20",
  "detail": { … },
  "event": { … }
}

Key fields

Field Type Example
id string 3ffea334-0d99-4e78-b2bb-f0faabd20c8c
type string zen:event-type:organization.name_changed
account_id integer 11883297

Full schema: 18 fields.

Send example to Inspect → View as JSON

zen:event-type:organization.tags_changed

documented from Zendesk docs (example)

Organization's tags are updated

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

zendesk-zen-event-type-organization-tags-changed.json
{
  "type": "zen:event-type:organization.tags_changed",
  "account_id": 10973196,
  "id": "b4fa7f87-a23a-407b-8e18-23493b6c3cb6",
  "subject": "zen:organization:6607650028541",
  "time": "2099-07-07T03:44:09Z",
  "zendesk_event_version": "2022-06-20",
  "detail": { … },
  "event": { … }
}

Key fields

Field Type Example
id string b4fa7f87-a23a-407b-8e18-23493b6c3cb6
type string zen:event-type:organization.tags_changed
account_id integer 10973196

Full schema: 22 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.