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)

New theme created, not new theme files

Identified by x-shopify-topic header Resource themes

shopify-themes-create.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 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

Send example to Inspect → View as JSON

themes/delete

documented from Shopify docs (example)

Theme is deleted, not individual theme files

Identified by x-shopify-topic header Resource themes

shopify-themes-delete.json
{
  "id": 512162865275216960
}

Key fields

Field Type Example
id integer 512162865275216960

Full schema: 1 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

themes/publish

documented from Shopify docs (example)

Theme published with the main or mobile role

Identified by x-shopify-topic header Resource themes

shopify-themes-publish.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 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

Send example to Inspect → View as JSON

themes/update

documented from Shopify docs (example)

Theme updated; theme file changes don't trigger it

Identified by x-shopify-topic header Resource themes

shopify-themes-update.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 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

Send example to Inspect → View as 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.

Not affiliated with Shopify. Facts are compiled from public sources and linked inline.