# Shopify draft_orders webhook events

Shopify sends 3 draft_orders events: `draft_orders/create`, `draft_orders/delete` and `draft_orders/update`. 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)

## draft_orders/create

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

New draft order created

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

```json
{
  "id": 890612572568261600,
  "note": null,
  "email": "jon@doe.ca",
  "taxes_included": false,
  "currency": "CAD",
  "invoice_sent_at": null,
  "created_at": "2023-02-20T20:31:02-05:00",
  "updated_at": "2023-02-20T20:31:02-05:00",
  "tax_exempt": false,
  "completed_at": null,
  "status": "open",
  "total_price": "284.33"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `890612572568261600` |
| `status` | string | `open` |
| `total_price` | string | `284.33` Watch out: Numeric string. |
| `created_at` | string | `2023-02-20T20:31:02-05:00` |

From Shopify docs: content type `application/json`

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

## draft_orders/delete

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

Draft order is deleted

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

```json
{
  "id": 890612572568261600,
  "payment_terms": { … },
  "admin_graphql_api_id": "gid://shopify/DraftOrder/890612572568261625"
}
```

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

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

From Shopify docs: content type `application/json`

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

## draft_orders/update

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

Draft order changes

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

```json
{
  "id": 890612572568261600,
  "note": null,
  "email": "jon@doe.ca",
  "taxes_included": false,
  "currency": "CAD",
  "invoice_sent_at": null,
  "created_at": "2023-02-20T20:31:08-05:00",
  "updated_at": "2023-02-20T20:31:08-05:00",
  "tax_exempt": false,
  "completed_at": null,
  "status": "open",
  "total_price": "284.33"
}
```

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

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `890612572568261600` |
| `status` | string | `open` |
| `total_price` | string | `284.33` Watch out: Numeric string. |
| `created_at` | string | `2023-02-20T20:31:08-05:00` |

From Shopify docs: content type `application/json`

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