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 →
themes/create
documented from Shopify docs (example)
themes/create New theme created, not new theme files
Identified by x-shopify-topic header
Resource themes
{
"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 fields
| Field | Type | Example |
|---|---|---|
id | integer | 512162865275216960 |
created_at | string | 2023-02-20T20:52:55-05:00 |
Full schema: 9 fields.
From Shopify docs
-
Content type
application/json
themes/delete
documented from Shopify docs (example)
themes/delete Theme is deleted, not individual theme files
Identified by x-shopify-topic header
Resource themes
{
"id": 512162865275216960
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 512162865275216960 |
Full schema: 1 fields.
From Shopify docs
-
Content type
application/json
themes/publish
documented from Shopify docs (example)
themes/publish Theme published with the main or mobile role
Identified by x-shopify-topic header
Resource themes
{
"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 fields
| Field | Type | Example |
|---|---|---|
id | integer | 512162865275216960 |
created_at | string | 2023-02-20T20:52:53-05:00 |
Full schema: 9 fields.
From Shopify docs
-
Content type
application/json
themes/update
documented from Shopify docs (example)
themes/update Theme updated; theme file changes don't trigger it
Identified by x-shopify-topic header
Resource themes
{
"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 fields
| Field | Type | Example |
|---|---|---|
id | integer | 512162865275216960 |
created_at | string | 2023-02-20T20:52:45-05:00 |
Full schema: 9 fields.
From Shopify docs
-
Content type
application/json
Route Shopify events by type.
Event Gateway receives every Shopify delivery and filters and routes it by event type, so each service gets only the events it handles.