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_listings/add Collection listing is added
Identified by x-shopify-topic header
Resource collections
{
"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
collection_listings/remove
verified from a captured delivery
collection_listings/remove Collection listing is removed
Identified by x-shopify-topic header
Resource collections
{
"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
collection_listings/update
verified from a captured delivery
collection_listings/update Collection listing details change
Identified by x-shopify-topic header
Resource collections
{
"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
collection_publications/create
verified from a captured delivery
collection_publications/create New collection publication listing created
Identified by x-shopify-topic header
Resource collections
{
"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
collection_publications/delete
verified from a captured delivery
collection_publications/delete Collection publication listing is deleted
Identified by x-shopify-topic header
Resource collections
{
"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
collection_publications/update
verified from a captured delivery
collection_publications/update Collection publication listing changes
Identified by x-shopify-topic header
Resource collections
{
"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
collections/create
verified from a captured delivery
collections/create New collection created
Identified by x-shopify-topic header
Resource collections
{
"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
collections/delete
verified from a captured delivery
collections/delete Collection is deleted
Identified by x-shopify-topic header
Resource collections
{
"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
collections/update
verified from a captured delivery
collections/update Collection changes, including manual product additions, removals or rule edits
Identified by x-shopify-topic header
Resource collections
{
"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
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.