# 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`. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/zendesk/mcp-events).

These pages list the events a webhook subscribed to Zendesk events receives. A webhook connected to a [trigger or automation](https://developer.zendesk.com/documentation/webhooks/creating-and-monitoring-webhooks/#connecting-a-webhook-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](https://developer.zendesk.com/api-reference/integration-services/inbound-webhooks/inbound_webhooks/).

Agent skill: `npx skills add hookdeck/webhook-skills --skill zendesk-webhooks` ([details](https://hookdeck.com/webhooks/zendesk/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Zendesk's official docs](https://developer.zendesk.com/api-reference/event-connectors/webhooks/webhook-event-types/).

[Overview](https://hookdeck.com/webhooks/zendesk) · [Webhook events (142)](https://hookdeck.com/webhooks/zendesk/events) · [MCP events](https://hookdeck.com/webhooks/zendesk/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/zendesk/verify) · [Production guide](https://hookdeck.com/webhooks/zendesk/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/zendesk/skill)

## zen:event-type:article.author_changed

Confidence: documented · Schema: from Zendesk docs (example)

Article gets a different author

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-author-changed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX7773HNJ9CA89HX2P1MQ8E1` |
| `type` | string | `zen:event-type:article.author_changed` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-author-changed.json)

## zen:event-type:article.published

Confidence: documented · Schema: from Zendesk docs (example)

Help center article goes live

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-published.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX4P86AC7T0AFF86QGAHTEFR` |
| `type` | string | `zen:event-type:article.published` |
| `account_id` | integer | `10168721` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-published.json)

## zen:event-type:article.subscription_created

Confidence: documented · Schema: from Zendesk docs (example)

Someone subscribes to a help center article

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-subscription-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX9X40NW14K6WMKQRJDR15EB` |
| `type` | string | `zen:event-type:article.subscription_created` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-subscription-created.json)

## zen:event-type:article.unpublished

Confidence: documented · Schema: from Zendesk docs (example)

Help center article is withdrawn

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-unpublished.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX4PA0K4TC01K8AVSC3FW2ES` |
| `type` | string | `zen:event-type:article.unpublished` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-unpublished.json)

## zen:event-type:article.vote_created

Confidence: documented · Schema: from Zendesk docs (example)

Article receives a new vote

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-vote-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX787AW4SB2K793VM2T37X2Y` |
| `type` | string | `zen:event-type:article.vote_created` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-vote-created.json)

## zen:event-type:article.vote_changed

Confidence: documented · Schema: from Zendesk docs (example)

Existing vote on an article is switched

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-vote-changed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX789JJXA5QSGQPK3XHB876Y` |
| `type` | string | `zen:event-type:article.vote_changed` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-vote-changed.json)

## zen:event-type:article.vote_removed

Confidence: documented · Schema: from Zendesk docs (example)

Vote on an article is withdrawn

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-vote-removed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX78A5SNQ3310ZYYKDHZEFC9` |
| `type` | string | `zen:event-type:article.vote_removed` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-vote-removed.json)

## zen:event-type:article.comment_created

Confidence: documented · Schema: from Zendesk docs (example)

New comment is posted on an article

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1QX01C889XV42S2J5T` |
| `type` | string | `zen:event-type:article.comment_created` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-created.json)

## zen:event-type:article.comment_changed

Confidence: documented · Schema: from Zendesk docs (example)

Comment on an article is edited

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-changed.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX7A6DJ7ZKDVQVMQ3AFHR4QJ` |
| `type` | string | `zen:event-type:article.comment_changed` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-changed.json)

## zen:event-type:article.comment_published

Confidence: documented · Schema: from Zendesk docs (example)

Comment on an article goes live

Identified by: type in the body; none on trigger or automation webhooks · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-published.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX79ST1VZRDG815C7450Y42M` |
| `type` | string | `zen:event-type:article.comment_published` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-published.json)

## zen:event-type:article.comment_unpublished

Confidence: documented · Schema: 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 · Object: `article`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-unpublished.json)

| Key field | Type | Example |
|---|---|---|
| `id` | string | `01GX7ABVG0B7WDDXEKJNJ30ZVN` |
| `type` | string | `zen:event-type:article.comment_unpublished` |
| `account_id` | integer | `11896485` |

[View as JSON](https://hookdeck.com/webhooks/zendesk/events/zen-event-type-article-comment-unpublished.json)

---

Not affiliated with Zendesk. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/zendesk.json) · [Report a correction](https://hookdeck.com/contact)
