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)

New rollout created with its treatments and changes

Identified by x-shopify-topic header Resource rollouts

shopify-rollouts-create.json
{
  "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

Send example to Inspect → View as JSON

rollouts/delete

documented from Shopify docs (example)

Rollout is deleted; archiving sends rollouts/update instead

Identified by x-shopify-topic header Resource rollouts

shopify-rollouts-delete.json
{
  "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

Send example to Inspect → View as JSON

rollouts/resource_change_added

documented from Shopify docs (example)

Change added to a rollout treatment

Identified by x-shopify-topic header Resource rollouts

shopify-rollouts-resource-change-added.json
{
  "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

Send example to Inspect → View as JSON

rollouts/resource_change_removed

documented from Shopify docs (example)

Change removed from a rollout treatment

Identified by x-shopify-topic header Resource rollouts

shopify-rollouts-resource-change-removed.json
{
  "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

Send example to Inspect → View as JSON

rollouts/resource_change_updated

documented from Shopify docs (example)

Rollout treatment change now targets another resource

Identified by x-shopify-topic header Resource rollouts

shopify-rollouts-resource-change-updated.json
{
  "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

Send example to Inspect → View as JSON

rollouts/update

documented from Shopify docs (example)

Rollout's status, configuration, treatments, changes or traffic allocation change

Identified by x-shopify-topic header Resource rollouts

shopify-rollouts-update.json
{
  "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

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.