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)
zen:event-type:organization.created New organization is added
Identified by type in the body; none on trigger or automation webhooks
Resource organization
{
"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.
zen:event-type:organization.custom_field_changed
documented from Zendesk docs (example)
zen:event-type:organization.custom_field_changed Custom organization field's value is edited
Identified by type in the body; none on trigger or automation webhooks
Resource organization
{
"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.
zen:event-type:organization.deleted
documented from Zendesk docs (example)
zen:event-type:organization.deleted Organization is removed
Identified by type in the body; none on trigger or automation webhooks
Resource organization
{
"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.
zen:event-type:organization.external_id_changed
documented from Zendesk docs (example)
zen:event-type:organization.external_id_changed Organization gets a different external id
Identified by type in the body; none on trigger or automation webhooks
Resource organization
{
"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.
zen:event-type:organization.name_changed
documented from Zendesk docs (example)
zen:event-type:organization.name_changed Organization is renamed
Identified by type in the body; none on trigger or automation webhooks
Resource organization
{
"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.
zen:event-type:organization.tags_changed
documented from Zendesk docs (example)
zen:event-type:organization.tags_changed Organization's tags are updated
Identified by type in the body; none on trigger or automation webhooks
Resource organization
{
"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.
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.