# Shopify themes webhook events

Shopify sends 4 themes events, including `themes/create`, `themes/delete` and `themes/publish`. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events).

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

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

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

## themes/create

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

New theme created, not new theme files

Identified by: x-shopify-topic header · Object: `themes`

```json
{
  "id": 512162865275216960,
  "name": "Comfort",
  "created_at": "2023-02-20T20:52:55-05:00",
  "updated_at": "2023-02-20T20:52:55-05:00",
  "role": "main",
  "theme_store_id": 1234,
  "previewable": true,
  "processing": false,
  "admin_graphql_api_id": "gid://shopify/Theme/512162865275216980"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `512162865275216960` |
| `created_at` | string | `2023-02-20T20:52:55-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/themes-create.json)

## themes/delete

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

Theme is deleted, not individual theme files

Identified by: x-shopify-topic header · Object: `themes`

```json
{
  "id": 512162865275216960
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `512162865275216960` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/themes-delete.json)

## themes/publish

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

Theme published with the main or mobile role

Identified by: x-shopify-topic header · Object: `themes`

```json
{
  "id": 512162865275216960,
  "name": "Comfort",
  "created_at": "2023-02-20T20:52:53-05:00",
  "updated_at": "2023-02-20T20:52:53-05:00",
  "role": "main",
  "theme_store_id": 1234,
  "previewable": true,
  "processing": false,
  "admin_graphql_api_id": "gid://shopify/Theme/512162865275216980"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `512162865275216960` |
| `created_at` | string | `2023-02-20T20:52:53-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/themes-publish.json)

## themes/update

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

Theme updated; theme file changes don't trigger it

Identified by: x-shopify-topic header · Object: `themes`

```json
{
  "id": 512162865275216960,
  "name": "Comfort",
  "created_at": "2023-02-20T20:52:45-05:00",
  "updated_at": "2023-02-20T20:52:45-05:00",
  "role": "main",
  "theme_store_id": 1234,
  "previewable": true,
  "processing": false,
  "admin_graphql_api_id": "gid://shopify/Theme/512162865275216980"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `512162865275216960` |
| `created_at` | string | `2023-02-20T20:52:45-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/themes-update.json)

---

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