Webhook event types

This reference documentation provides a list of available event types for Zendesk webhooks and their related request payloads. For more information about webhooks, seeCreating and monitoring webhooks.

Supported event types

Supported event types are grouped by domain:

• Article events
• Community post events
• Organization events
• User events

Note:To send webhook requests based on ticket activity, connect the webhook to atriggerorautomationinstead. SeeCreating and monitoring webhooks.

Event schema

HTTP requests for Zendesk event webhooks use a similar JSON payload schema with shared properties. Events with the same event type use the same payload schema. An example event payload:

             

              
{"type":"zen:event-type:user.active_changed","account_id":12514403,"id":"2b24ef10-19d4-4740-93cf-8f98ec4776c0","time":“2099 - 07 - 04 - t05:33:18z”,"zendesk_event_version":"2022-06-20","subject":"zen:user:6596848315901","detail":{"created_at":"2099-07-04T05:27:58Z","email":"[email protected]","external_id":"","default_group_id":"0","id":"6596848315901","organization_id":"0","role":"end-user","updated_at":“2099 - 07 - 04 - t05:33:18z”},"event":{"current":false,"previous":true}}
             

Top-level properties

All event payloads contain the following top-level properties.

Detail object

Thedetailobject contains information about the resource created or changed by the event. The object's properties vary based on the event's domain. You can determine an event's domain from the event'stypeprefix.

Event object

Theeventobject contains information about the event's changes. The object's properties vary based on event type.