# 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](https://hookdeck.com/webhooks/shopify/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill shopify-webhooks` ([details](https://hookdeck.com/webhooks/shopify/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

[Overview](https://hookdeck.com/webhooks/shopify) · [Webhook events (230)](https://hookdeck.com/webhooks/shopify/events) · [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/shopify/verify) · [Production guide](https://hookdeck.com/webhooks/shopify/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/shopify/skill)

## rollouts/create

Confidence: documented · Schema: from Shopify docs (example)

New rollout created with its treatments and changes

Identified by: x-shopify-topic header · Object: `rollouts`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-create.json)

| Key field | Type | Example |
|---|---|---|
| `status` | string | `ACTIVE` |
| `started_at` | string | `2026-09-15T12:00:00.000Z` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-create.json)

## rollouts/delete

Confidence: documented · Schema: from Shopify docs (example)

Rollout is deleted; archiving sends rollouts/update instead

Identified by: x-shopify-topic header · Object: `rollouts`

```json
{
  "admin_graphql_api_id": "gid://shopify/Rollout/123",
  "deleted_at": "2026-09-15T12:00:00.000Z"
}
```



| Key field | Type | Example |
|---|---|---|
| `deleted_at` | string | `2026-09-15T12:00:00.000Z` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-delete.json)

## rollouts/resource_change_added

Confidence: documented · Schema: from Shopify docs (example)

Change added to a rollout treatment

Identified by: x-shopify-topic header · Object: `rollouts`

```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 field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2026-09-21T16:00:00.000000Z` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-resource-change-added.json)

## rollouts/resource_change_removed

Confidence: documented · Schema: from Shopify docs (example)

Change removed from a rollout treatment

Identified by: x-shopify-topic header · Object: `rollouts`

```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 field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2026-09-21T16:00:00.000000Z` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-resource-change-removed.json)

## rollouts/resource_change_updated

Confidence: documented · Schema: from Shopify docs (example)

Rollout treatment change now targets another resource

Identified by: x-shopify-topic header · Object: `rollouts`

```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 field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2026-09-21T16:00:00.000000Z` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-resource-change-updated.json)

## rollouts/update

Confidence: documented · Schema: from Shopify docs (example)

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

Identified by: x-shopify-topic header · Object: `rollouts`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-update.json)

| Key field | Type | Example |
|---|---|---|
| `status` | string | `ACTIVE` |
| `started_at` | string | `2026-09-15T12:00:00.000Z` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/rollouts-update.json)

---

Not affiliated with Shopify. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/shopify.json) · [Report a correction](https://hookdeck.com/contact)
