Shopify products webhook events

Shopify sends 19 product events, covering products, variants, listings, publications and product feeds. products/update also fires when variants are added, removed or updated, so it's the one most integrations use.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

products/create

documented from Shopify docs (example)

New product created

Identified by x-shopify-topic header Resource products

shopify-products-create.json
{
  "id": 788032119674292900,
  "title": "Example T-Shirt",
  "body_html": "An example T-Shirt",
  "vendor": "Acme",
  "product_type": "Shirts",
  "created_at": null,
  "handle": "example-t-shirt",
  "updated_at": "2023-02-20T20:50:20-05:00",
  "published_at": "2023-02-20T20:50:20-05:00",
  "template_suffix": null,
  "status": "active"
}

Key fields

Field Type Example
id integer 788032119674292900
status string active
updated_at string 2023-02-20T20:50:20-05:00

Full schema: 46 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

products/update

documented from Shopify docs (example)

Product is updated or ordered, or its variants change

Identified by x-shopify-topic header Resource products

shopify-products-update.json
{
  "id": 788032119674292900,
  "title": "Example T-Shirt",
  "body_html": "An example T-Shirt",
  "vendor": "Acme",
  "product_type": "Shirts",
  "created_at": null,
  "handle": "example-t-shirt",
  "updated_at": "2023-02-20T20:50:16-05:00",
  "published_at": "2023-02-20T20:50:16-05:00",
  "template_suffix": null,
  "status": "active"
}

Key fields

Field Type Example
id integer 788032119674292900
status string active
updated_at string 2023-02-20T20:50:16-05:00

Full schema: 46 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

products/delete

documented from Shopify docs (example)

Product is deleted

Identified by x-shopify-topic header Resource products

shopify-products-delete.json
{
  "id": 788032119674292900
}

Key fields

Field Type Example
id integer 788032119674292900

Full schema: 1 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_feeds/create

documented from Shopify docs (example)

New product feed created

Identified by x-shopify-topic header Resource products

shopify-product-feeds-create.json
{
  "id": "gid://shopify/ProductFeed/",
  "country": "CA",
  "language": "EN",
  "status": ""
}

Key fields

Field Type Example
id string gid://shopify/ProductFeed/
status string

Full schema: 4 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_feeds/full_sync

documented from Shopify docs (example)

Full sync runs for a product feed

Identified by x-shopify-topic header Resource products

shopify-product-feeds-full-sync.json
{
  "metadata": { … },
  "productFeed": { … },
  "product": { … }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_feeds/full_sync_finish

documented from Shopify docs (example)

Product feed full sync finishes

Identified by x-shopify-topic header Resource products

shopify-product-feeds-full-sync-finish.json
{
  "metadata": { … },
  "productFeed": { … },
  "fullSync": { … }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_feeds/incremental_sync

documented from Shopify docs (example)

Product publication created, updated or removed for a feed

Identified by x-shopify-topic header Resource products

shopify-product-feeds-incremental-sync.json
{
  "metadata": { … },
  "productFeed": { … },
  "product": { … }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_feeds/update

documented from Shopify docs (example)

Product feed changes

Identified by x-shopify-topic header Resource products

shopify-product-feeds-update.json
{
  "id": "gid://shopify/ProductFeed/",
  "country": "CA",
  "language": "EN",
  "status": ""
}

Key fields

Field Type Example
id string gid://shopify/ProductFeed/
status string

Full schema: 4 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_listings/add

documented from Shopify docs (example)

Active product listed on a channel

Identified by x-shopify-topic header Resource products

shopify-product-listings-add.json
{
  "product_listing": {
    "product_id": 788032119674292900,
    "created_at": null,
    "updated_at": "2021-12-31T19:00:00-05:00",
    "body_html": "An example T-Shirt",
    "handle": "example-t-shirt",
    "product_type": "Shirts",
    "title": "Example T-Shirt",
    "vendor": "Acme",
    "available": false
  }
}

Key fields

Field Type Example
product_listing.updated_at string 2021-12-31T19:00:00-05:00

Full schema: 49 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_listings/remove

documented from Shopify docs (example)

Product listing removed from a channel

Identified by x-shopify-topic header Resource products

shopify-product-listings-remove.json
{
  "product_listing": {
    "product_id": 788032119674292900
  }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_listings/update

documented from Shopify docs (example)

Product publication changes

Identified by x-shopify-topic header Resource products

shopify-product-listings-update.json
{
  "product_listing": {
    "product_id": 788032119674292900,
    "created_at": null,
    "updated_at": "2021-12-31T19:00:00-05:00",
    "body_html": "An example T-Shirt",
    "handle": "example-t-shirt",
    "product_type": "Shirts",
    "title": "Example T-Shirt",
    "vendor": "Acme",
    "available": false
  }
}

Key fields

Field Type Example
product_listing.updated_at string 2021-12-31T19:00:00-05:00

Full schema: 49 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_publications/create

documented from Shopify docs (example)

Active product's publication created or published on your app

Identified by x-shopify-topic header Resource products

shopify-product-publications-create.json
{
  "id": null,
  "publication_id": null,
  "published_at": "2021-12-31T19:00:00-05:00",
  "published": true,
  "created_at": null,
  "updated_at": null,
  "product_id": 788032119674292900
}

Key fields

Field Type Example
published_at string 2021-12-31T19:00:00-05:00

Full schema: 7 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_publications/delete

documented from Shopify docs (example)

Active product's publication removed or unpublished from your app

Identified by x-shopify-topic header Resource products

shopify-product-publications-delete.json
{
  "id": null
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

product_publications/update

documented from Shopify docs (example)

Product publication changes on your app

Identified by x-shopify-topic header Resource products

shopify-product-publications-update.json
{
  "id": null,
  "publication_id": null,
  "published_at": "2021-12-31T19:00:00-05:00",
  "published": true,
  "created_at": null,
  "updated_at": null,
  "product_id": 788032119674292900
}

Key fields

Field Type Example
published_at string 2021-12-31T19:00:00-05:00

Full schema: 7 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

scheduled_product_listings/add

documented from Shopify docs (example)

Product scheduled for publishing

Identified by x-shopify-topic header Resource products

shopify-scheduled-product-listings-add.json
{
  "scheduled_product_listing": {
    "product_id": 788032119674292900,
    "created_at": null,
    "updated_at": "2021-12-31T19:00:00-05:00",
    "body_html": "An example T-Shirt",
    "handle": "example-t-shirt",
    "product_type": "Shirts",
    "title": "Example T-Shirt",
    "vendor": "Acme",
    "available": false
  }
}

Key fields

Field Type Example
scheduled_product_listing.updated_at string 2021-12-31T19:00:00-05:00

Full schema: 49 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

scheduled_product_listings/remove

documented from Shopify docs (example)

Product no longer scheduled for publishing

Identified by x-shopify-topic header Resource products

shopify-scheduled-product-listings-remove.json
{
  "scheduled_product_listing": {
    "product_id": 788032119674292900
  }
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

scheduled_product_listings/update

documented from Shopify docs (example)

Product's scheduled availability date changes

Identified by x-shopify-topic header Resource products

shopify-scheduled-product-listings-update.json
{
  "scheduled_product_listing": {
    "product_id": 788032119674292900,
    "created_at": null,
    "updated_at": "2021-12-31T19:00:00-05:00",
    "body_html": "An example T-Shirt",
    "handle": "example-t-shirt",
    "product_type": "Shirts",
    "title": "Example T-Shirt",
    "vendor": "Acme",
    "available": false
  }
}

Key fields

Field Type Example
scheduled_product_listing.updated_at string 2021-12-31T19:00:00-05:00

Full schema: 49 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

variants/in_stock

documented from Shopify docs (example)

Variant comes back into stock

Identified by x-shopify-topic header Resource products

shopify-variants-in-stock.json
{
  "id": 642667041472714000,
  "product_id": 788032119674292900,
  "title": "Small",
  "price": "19.99",
  "sku": "example-shirt-s",
  "position": 1,
  "inventory_policy": "deny",
  "compare_at_price": "24.99",
  "option1": "Small",
  "option2": null,
  "created_at": "2021-12-29T19:00:00-05:00"
}

Key fields

Field Type Example
id integer 642667041472714000
price string 19.99 Watch out Numeric string.
created_at string 2021-12-29T19:00:00-05:00

Full schema: 19 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

variants/out_of_stock

documented from Shopify docs (example)

Variant runs out of stock

Identified by x-shopify-topic header Resource products

shopify-variants-out-of-stock.json
{
  "id": 642667041472714000,
  "product_id": 788032119674292900,
  "title": "Small",
  "price": "19.99",
  "sku": "example-shirt-s",
  "position": 1,
  "inventory_policy": "deny",
  "compare_at_price": "24.99",
  "option1": "Small",
  "option2": null,
  "created_at": "2021-12-29T19:00:00-05:00"
}

Key fields

Field Type Example
id integer 642667041472714000
price string 19.99 Watch out Numeric string.
created_at string 2021-12-29T19:00:00-05:00

Full schema: 19 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.