Shopify rollouts webhook events
Shopify sends 6 rollouts events, including rollouts/create, rollouts/delete and rollouts/resource_change_added.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
rollouts/create
documented from Shopify docs (example)
rollouts/create New rollout created with its treatments and changes
Identified by x-shopify-topic header
Resource rollouts
{
"admin_graphql_api_id": "gid://shopify/Rollout/123",
"name": "Example rollout",
"status": "ACTIVE",
"traffic_allocation": 50,
"effective_traffic_allocation": 50,
"schedule": { … },
"started_at": "2026-09-15T12:00:00.000Z",
"concluded_at": null,
"archived_at": null,
"created_at": "2026-09-15T12:00:00.000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
status | string | ACTIVE |
started_at | string | 2026-09-15T12:00:00.000Z |
Full schema: 13 fields.
From Shopify docs
-
Content type
application/json
rollouts/delete
documented from Shopify docs (example)
rollouts/delete Rollout is deleted; archiving sends rollouts/update instead
Identified by x-shopify-topic header
Resource rollouts
{
"admin_graphql_api_id": "gid://shopify/Rollout/123",
"deleted_at": "2026-09-15T12:00:00.000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
deleted_at | string | 2026-09-15T12:00:00.000Z |
Full schema: 2 fields.
From Shopify docs
-
Content type
application/json
rollouts/resource_change_added
documented from Shopify docs (example)
rollouts/resource_change_added Change added to a rollout treatment
Identified by x-shopify-topic header
Resource rollouts
{
"admin_graphql_api_id": "gid://shopify/Rollout/123",
"treatment_id": "gid://shopify/RolloutTreatment/456",
"change_id": "gid://shopify/RolloutThemePublishChange/c265076973b138de5ca1d63e4d08860deb31a8903b277cc8575a2035048ccb03",
"resource_id": "gid://shopify/OnlineStoreTheme/401",
"occurred_at": "2026-09-21T16:00:00.000000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2026-09-21T16:00:00.000000Z |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
rollouts/resource_change_removed
documented from Shopify docs (example)
rollouts/resource_change_removed Change removed from a rollout treatment
Identified by x-shopify-topic header
Resource rollouts
{
"admin_graphql_api_id": "gid://shopify/Rollout/123",
"treatment_id": "gid://shopify/RolloutTreatment/456",
"change_id": "gid://shopify/RolloutThemePublishChange/c265076973b138de5ca1d63e4d08860deb31a8903b277cc8575a2035048ccb03",
"resource_id": "gid://shopify/OnlineStoreTheme/401",
"occurred_at": "2026-09-21T16:00:00.000000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2026-09-21T16:00:00.000000Z |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
rollouts/resource_change_updated
documented from Shopify docs (example)
rollouts/resource_change_updated Rollout treatment change now targets another resource
Identified by x-shopify-topic header
Resource rollouts
{
"admin_graphql_api_id": "gid://shopify/Rollout/123",
"treatment_id": "gid://shopify/RolloutTreatment/456",
"change_id": "gid://shopify/RolloutThemePublishChange/c265076973b138de5ca1d63e4d08860deb31a8903b277cc8575a2035048ccb03",
"resource_id": "gid://shopify/OnlineStoreTheme/402",
"occurred_at": "2026-09-21T16:00:00.000000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2026-09-21T16:00:00.000000Z |
Full schema: 5 fields.
From Shopify docs
-
Content type
application/json
rollouts/update
documented from Shopify docs (example)
rollouts/update Rollout's status, configuration, treatments, changes or traffic allocation change
Identified by x-shopify-topic header
Resource rollouts
{
"admin_graphql_api_id": "gid://shopify/Rollout/123",
"name": "Example rollout",
"status": "ACTIVE",
"traffic_allocation": 50,
"effective_traffic_allocation": 50,
"schedule": { … },
"started_at": "2026-09-15T12:00:00.000Z",
"concluded_at": null,
"archived_at": null,
"created_at": "2026-09-15T12:00:00.000Z"
} Key fields
| Field | Type | Example |
|---|---|---|
status | string | ACTIVE |
started_at | string | 2026-09-15T12:00:00.000Z |
Full schema: 13 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.