# Shopify orders webhook events

Shopify sends 17 order events, including transactions, refunds and requested edits. `orders/create` is the one most integrations start with, and `orders/paid` says an order has been paid. 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)

## orders/create

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

New order created

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2023-02-20T20:50:03-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "31.99"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `31.99` Watch out: Numeric string. |
| `cancelled_at` | string | `2023-02-20T20:50:03-05:00` |

From Shopify docs: content type `application/json`

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

## orders/updated

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

Order details change

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2023-02-20T20:50:50-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "31.99"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `31.99` Watch out: Numeric string. |
| `cancelled_at` | string | `2023-02-20T20:50:50-05:00` |

From Shopify docs: content type `application/json`

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

## orders/paid

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

Order is paid

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2023-02-20T20:50:47-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "31.99"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `31.99` Watch out: Numeric string. |
| `cancelled_at` | string | `2023-02-20T20:50:47-05:00` |

From Shopify docs: content type `application/json`

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

## orders/cancelled

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

Order is cancelled

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2023-02-20T20:49:46-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "31.99"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `31.99` Watch out: Numeric string. |
| `cancelled_at` | string | `2023-02-20T20:49:46-05:00` |

From Shopify docs: content type `application/json`

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

## orders/fulfilled

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

Order is fulfilled

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2023-02-20T20:50:45-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "31.99"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `31.99` Watch out: Numeric string. |
| `cancelled_at` | string | `2023-02-20T20:50:45-05:00` |

From Shopify docs: content type `application/json`

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

## order_transactions/create

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

Order transaction succeeds, fails or errors

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

```json
{
  "id": 120560818172775260,
  "order_id": 820982911946154500,
  "kind": "authorization",
  "gateway": "visa",
  "status": "success",
  "message": null,
  "created_at": "2023-02-20T20:52:48-05:00",
  "test": false,
  "authorization": "1001",
  "location_id": null,
  "user_id": null,
  "amount": "36.99"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `120560818172775260` |
| `status` | string | `success` |
| `amount` | string | `36.99` Watch out: Numeric string. |
| `created_at` | string | `2023-02-20T20:52:48-05:00` |

From Shopify docs: content type `application/json`

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

## orders/delete

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

Order is deleted

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2021-12-31T19:00:00-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "398.00"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `398.00` Watch out: Numeric string. |
| `cancelled_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

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

## orders/edited

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

Order is edited

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

```json
{
  "order_edit": {
    "id": 78912328793123780,
    "app_id": null,
    "created_at": "2023-02-20T20:50:42-05:00",
    "notify_customer": false,
    "order_id": 820982911946154500,
    "staff_note": "",
    "user_id": null,
    "line_items": { … },
    "discounts": { … },
    "shipping_lines": { … }
  }
}
```

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

| Key field | Type | Example |
|---|---|---|
| `order_edit.id` | integer | `78912328793123780` |
| `order_edit.created_at` | string | `2023-02-20T20:50:42-05:00` |

From Shopify docs: content type `application/json`

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

## orders/link_requested

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

Customer asks for a new link from an expired order status page

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2021-12-31T19:00:00-05:00",
  "cart_token": null,
  "checkout_token": null,
  "client_details": null,
  "current_subtotal_price": "414.95"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `414.95` Watch out: Numeric string. |
| `cancelled_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/orders-link-requested.json)

## orders/partially_fulfilled

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

Order is partially fulfilled

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

```json
{
  "id": 820982911946154500,
  "admin_graphql_api_id": "gid://shopify/Order/820982911946154508",
  "app_id": null,
  "browser_ip": null,
  "buyer_accepts_marketing": true,
  "cancel_reason": "customer",
  "cancelled_at": "2021-12-31T19:00:00-05:00",
  "cart_token": null,
  "checkout_id": null,
  "checkout_token": null,
  "current_subtotal_price": "398.00"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `820982911946154500` |
| `current_subtotal_price` | string | `398.00` Watch out: Numeric string. |
| `cancelled_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/orders-partially-fulfilled.json)

## orders/risk_assessment_changed

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

New risk assessment available on an order

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

```json
{
  "provider_id": null,
  "provider_title": null,
  "risk_level": "medium",
  "created_at": null
}
```



From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/orders-risk-assessment-changed.json)

## orders/shopify_protect_eligibility_changed

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

Order's Shopify Protect eligibility changes

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

```json
{
  "order_id": 1,
  "status": "active",
  "eligibility": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/orders-shopify-protect-eligibility-changed.json)

| Key field | Type | Example |
|---|---|---|
| `status` | string | `active` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/orders-shopify-protect-eligibility-changed.json)

## refunds/create

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

Refund created on an order, regardless of money movement

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

```json
{
  "id": 890088186047892400,
  "order_id": 820982911946154500,
  "created_at": null,
  "note": "Things were damaged",
  "user_id": 77784088788,
  "processed_at": null,
  "restock": false,
  "duties": [ … ],
  "total_duties_set": { … }
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `890088186047892400` |

From Shopify docs: content type `application/json`

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

## tender_transactions/create

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

New tender transaction created

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

```json
{
  "id": 220982911946154500,
  "order_id": 820982911946154500,
  "amount": "36.99",
  "currency": "CAD",
  "user_id": null,
  "test": false,
  "processed_at": null,
  "remote_reference": "1001",
  "payment_details": null,
  "payment_method": "unknown"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `220982911946154500` |
| `amount` | string | `36.99` Watch out: Numeric string. |

From Shopify docs: content type `application/json`

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

## requested_order_edit/created

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

Customer requests an edit to an order

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

```json
{
  "id": 963881762,
  "admin_graphql_api_id": "gid://shopify/RequestedOrderEdit/963881762",
  "status": "requested",
  "order_id": 820982911946154500,
  "requested_at": "2026-01-15T07:00:00-05:00",
  "line_items": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/requested-order-edit-created.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `963881762` |
| `status` | string | `requested` |
| `requested_at` | string | `2026-01-15T07:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/requested-order-edit-created.json)

## requested_order_edit/declined

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

Requested order edit is declined

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

```json
{
  "id": 963881762,
  "admin_graphql_api_id": "gid://shopify/RequestedOrderEdit/963881762",
  "status": "declined",
  "order_id": 820982911946154500,
  "requested_at": "2026-01-15T07:00:00-05:00",
  "line_items": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/requested-order-edit-declined.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `963881762` |
| `status` | string | `declined` |
| `requested_at` | string | `2026-01-15T07:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/requested-order-edit-declined.json)

## requested_order_edit/resolved

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

Requested order edit is resolved

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

```json
{
  "id": 963881762,
  "admin_graphql_api_id": "gid://shopify/RequestedOrderEdit/963881762",
  "status": "resolved",
  "order_id": 820982911946154500,
  "requested_at": "2026-01-15T07:00:00-05:00",
  "line_items": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/requested-order-edit-resolved.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `963881762` |
| `status` | string | `resolved` |
| `requested_at` | string | `2026-01-15T07:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/requested-order-edit-resolved.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)
