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)

Article gets a different author

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

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

Send example to Inspect → View as JSON

zen:event-type:article.published

documented from Zendesk docs (example)

Help center article goes live

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

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

Send example to Inspect → View as JSON

zen:event-type:article.subscription_created

documented from Zendesk docs (example)

Someone subscribes to a help center article

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

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

Send example to Inspect → View as JSON

zen:event-type:article.unpublished

documented from Zendesk docs (example)

Help center article is withdrawn

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

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

Send example to Inspect → View as JSON

zen:event-type:article.vote_created

documented from Zendesk docs (example)

Article receives a new vote

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

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

Send example to Inspect → View as JSON

zen:event-type:article.vote_changed

documented from Zendesk docs (example)

Existing vote on an article is switched

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

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

Send example to Inspect → View as JSON

zen:event-type:article.vote_removed

documented from Zendesk docs (example)

Vote on an article is withdrawn

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

zendesk-zen-event-type-article-vote-removed.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:article.comment_created

documented from Zendesk docs (example)

New comment is posted on an article

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

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

Send example to Inspect → View as JSON

zen:event-type:article.comment_changed

documented from Zendesk docs (example)

Comment on an article is edited

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

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

Send example to Inspect → View as JSON

zen:event-type:article.comment_published

documented from Zendesk docs (example)

Comment on an article goes live

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

zendesk-zen-event-type-article-comment-published.json
{
  "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.

Send example to Inspect → View as JSON

zen:event-type:article.comment_unpublished

documented from Zendesk docs (example)

Article comment is hidden, deleted or marked as spam

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

zendesk-zen-event-type-article-comment-unpublished.json
{
  "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.

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.