Shopify collections webhook events

Shopify sends 9 collections events, including collection_listings/add, collection_listings/remove and collection_listings/update.

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

collection_listings/add

verified from a captured delivery

Collection listing is added

Identified by x-shopify-topic header Resource collections

shopify-collection-listings-add.json
{
  "collection_listing": {
    "collection_id": 408372092144951400,
    "updated_at": null,
    "body_html": "<b>Some HTML</b>",
    "default_product_image": null,
    "handle": "mynewcollection",
    "image": null,
    "title": "My New Collection",
    "sort_order": null,
    "published_at": "2021-12-31T19:00:00-05:00"
  }
}

Key fields

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

Full schema: 10 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers content-type , user-agent , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-webhook-id

Send example to Inspect → View as JSON

collection_listings/remove

verified from a captured delivery

Collection listing is removed

Identified by x-shopify-topic header Resource collections

shopify-collection-listings-remove.json
{
  "collection_listing": {
    "collection_id": 408372092144951400
  }
}

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers content-type , user-agent , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-webhook-id

Send example to Inspect → View as JSON

collection_listings/update

verified from a captured delivery

Collection listing details change

Identified by x-shopify-topic header Resource collections

shopify-collection-listings-update.json
{
  "collection_listing": {
    "collection_id": 408372092144951400,
    "updated_at": null,
    "body_html": "<b>Some HTML</b>",
    "default_product_image": null,
    "handle": "mynewcollection",
    "image": null,
    "title": "My New Collection",
    "sort_order": null,
    "published_at": "2021-12-31T19:00:00-05:00"
  }
}

Key fields

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

Full schema: 10 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers content-type , user-agent , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-webhook-id

Send example to Inspect → View as JSON

collection_publications/create

verified from a captured delivery

New collection publication listing created

Identified by x-shopify-topic header Resource collections

shopify-collection-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,
  "collection_id": 408372092144951400
}

Key fields

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

Full schema: 7 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

collection_publications/delete

verified from a captured delivery

Collection publication listing is deleted

Identified by x-shopify-topic header Resource collections

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

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

collection_publications/update

verified from a captured delivery

Collection publication listing changes

Identified by x-shopify-topic header Resource collections

shopify-collection-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,
  "collection_id": 408372092144951400
}

Key fields

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

Full schema: 7 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-test , x-shopify-topic , x-shopify-triggered-at , x-shopify-webhook-id

Send example to Inspect → View as JSON

collections/create

verified from a captured delivery

New collection created

Identified by x-shopify-topic header Resource collections

shopify-collections-create.json
{
  "id": 408372092144951400,
  "handle": "mynewcollection",
  "title": "My New Collection",
  "updated_at": "2023-02-20T20:27:29-05:00",
  "body_html": "<b>Some HTML</b>",
  "published_at": "2023-02-20T17:27:29-05:00",
  "sort_order": null,
  "template_suffix": null,
  "published_scope": "web",
  "admin_graphql_api_id": "gid://shopify/Collection/408372092144951419"
}

Key fields

Field Type Example
id integer 408372092144951400
updated_at string 2023-02-20T20:27:29-05:00

Full schema: 10 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-collection-id , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-topic , x-shopify-trace-context , x-shopify-webhook-id

Send example to Inspect → View as JSON

collections/delete

verified from a captured delivery

Collection is deleted

Identified by x-shopify-topic header Resource collections

shopify-collections-delete.json
{
  "id": 408372092144951400,
  "published_scope": "web",
  "admin_graphql_api_id": "gid://shopify/Collection/408372092144951419"
}

Key fields

Field Type Example
id integer 408372092144951400

Full schema: 3 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-collection-id , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-topic , x-shopify-trace-context , x-shopify-webhook-id

Send example to Inspect → View as JSON

collections/update

verified from a captured delivery

Collection changes, including manual product additions, removals or rule edits

Identified by x-shopify-topic header Resource collections

shopify-collections-update.json
{
  "id": 408372092144951400,
  "handle": "mynewcollection",
  "title": "My New Collection",
  "updated_at": "2023-02-20T20:27:50-05:00",
  "body_html": "<b>Some HTML</b>",
  "published_at": "2023-02-20T17:27:50-05:00",
  "sort_order": null,
  "template_suffix": null,
  "published_scope": "web",
  "admin_graphql_api_id": "gid://shopify/Collection/408372092144951419"
}

Key fields

Field Type Example
id integer 408372092144951400
updated_at string 2023-02-20T20:27:50-05:00

Full schema: 10 fields.

Seen in a captured delivery

  • Content type application/json
  • API version 2026-07
  • Headers user-agent , content-type , x-shopify-api-version , x-shopify-collection-id , x-shopify-hmac-sha256 , x-shopify-shop-domain , x-shopify-topic , x-shopify-trace-context , x-shopify-webhook-id

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.