Zendesk article webhook events
Zendesk sends 11 article events, including zen:event-type:article.author_changed, zen:event-type:article.published and zen:event-type:article.subscription_created.
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:article.author_changed
documented from Zendesk docs (example)
zen:event-type:article.author_changed Article gets a different author
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX7773HNJ9CA89HX2P1MQ8E1",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T22:46:48.627504986Z",
"type": "zen:event-type:article.author_changed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX7773HNJ9CA89HX2P1MQ8E1 |
type | string | zen:event-type:article.author_changed |
account_id | integer | 11896485 |
Full schema: 12 fields.
zen:event-type:article.published
documented from Zendesk docs (example)
zen:event-type:article.published Help center article goes live
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 10168721,
"detail": { … },
"event": { … },
"id": "01GX4P86AC7T0AFF86QGAHTEFR",
"subject": "zen:article:7005414006398",
"time": "2023-04-03T23:11:49.571545199Z",
"type": "zen:event-type:article.published",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX4P86AC7T0AFF86QGAHTEFR |
type | string | zen:event-type:article.published |
account_id | integer | 10168721 |
Full schema: 16 fields.
zen:event-type:article.subscription_created
documented from Zendesk docs (example)
zen:event-type:article.subscription_created Someone subscribes to a help center article
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX9X40NW14K6WMKQRJDR15EB",
"subject": "zen:article:6996623598974",
"time": "2023-04-05T23:48:04.922543199Z",
"type": "zen:event-type:article.subscription_created",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX9X40NW14K6WMKQRJDR15EB |
type | string | zen:event-type:article.subscription_created |
account_id | integer | 11896485 |
Full schema: 14 fields.
zen:event-type:article.unpublished
documented from Zendesk docs (example)
zen:event-type:article.unpublished Help center article is withdrawn
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX4PA0K4TC01K8AVSC3FW2ES",
"subject": "zen:article:7005450498174",
"time": "2023-04-03T23:12:49.245377265Z",
"type": "zen:event-type:article.unpublished",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX4PA0K4TC01K8AVSC3FW2ES |
type | string | zen:event-type:article.unpublished |
account_id | integer | 11896485 |
Full schema: 11 fields.
zen:event-type:article.vote_created
documented from Zendesk docs (example)
zen:event-type:article.vote_created Article receives a new vote
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX787AW4SB2K793VM2T37X2Y",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:04:24.706715957Z",
"type": "zen:event-type:article.vote_created",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX787AW4SB2K793VM2T37X2Y |
type | string | zen:event-type:article.vote_created |
account_id | integer | 11896485 |
Full schema: 15 fields.
zen:event-type:article.vote_changed
documented from Zendesk docs (example)
zen:event-type:article.vote_changed Existing vote on an article is switched
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX789JJXA5QSGQPK3XHB876Y",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:05:38.139607714Z",
"type": "zen:event-type:article.vote_changed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX789JJXA5QSGQPK3XHB876Y |
type | string | zen:event-type:article.vote_changed |
account_id | integer | 11896485 |
Full schema: 15 fields.
zen:event-type:article.vote_removed
documented from Zendesk docs (example)
zen:event-type:article.vote_removed Vote on an article is withdrawn
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX78A5SNQ3310ZYYKDHZEFC9",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:05:57.811184776Z",
"type": "zen:event-type:article.vote_removed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX78A5SNQ3310ZYYKDHZEFC9 |
type | string | zen:event-type:article.vote_removed |
account_id | integer | 11896485 |
Full schema: 13 fields.
zen:event-type:article.comment_created
documented from Zendesk docs (example)
zen:event-type:article.comment_created New comment is posted on an article
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX79ST1QX01C889XV42S2J5T",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:31:58.642630335Z",
"type": "zen:event-type:article.comment_created",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1QX01C889XV42S2J5T |
type | string | zen:event-type:article.comment_created |
account_id | integer | 11896485 |
Full schema: 15 fields.
zen:event-type:article.comment_changed
documented from Zendesk docs (example)
zen:event-type:article.comment_changed Comment on an article is edited
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX7A6DJ7ZKDVQVMQ3AFHR4QJ",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:38:51.834140851Z",
"type": "zen:event-type:article.comment_changed",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX7A6DJ7ZKDVQVMQ3AFHR4QJ |
type | string | zen:event-type:article.comment_changed |
account_id | integer | 11896485 |
Full schema: 13 fields.
zen:event-type:article.comment_published
documented from Zendesk docs (example)
zen:event-type:article.comment_published Comment on an article goes live
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX79ST1VZRDG815C7450Y42M",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:31:58.645534016Z",
"type": "zen:event-type:article.comment_published",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX79ST1VZRDG815C7450Y42M |
type | string | zen:event-type:article.comment_published |
account_id | integer | 11896485 |
Full schema: 14 fields.
zen:event-type:article.comment_unpublished
documented from Zendesk docs (example)
zen:event-type:article.comment_unpublished Article comment is hidden, deleted or marked as spam
Identified by type in the body; none on trigger or automation webhooks
Resource article
{
"account_id": 11896485,
"detail": { … },
"event": { … },
"id": "01GX7ABVG0B7WDDXEKJNJ30ZVN",
"subject": "zen:article:7005450498174",
"time": "2023-04-04T23:41:49.918525172Z",
"type": "zen:event-type:article.comment_unpublished",
"zendesk_event_version": "2022-11-06"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | 01GX7ABVG0B7WDDXEKJNJ30ZVN |
type | string | zen:event-type:article.comment_unpublished |
account_id | integer | 11896485 |
Full schema: 14 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.