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 →

draft_orders/create

documented from Shopify docs (example)

New draft order created

Identified by x-shopify-topic header Resource draft_orders

shopify-draft-orders-create.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"
}

Key fields

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

Full schema: 157 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

draft_orders/delete

documented from Shopify docs (example)

Draft order is deleted

Identified by x-shopify-topic header Resource draft_orders

shopify-draft-orders-delete.json
{
  "id": 890612572568261600,
  "payment_terms": { … },
  "admin_graphql_api_id": "gid://shopify/DraftOrder/890612572568261625"
}

Key fields

Field Type Example
id integer 890612572568261600

Full schema: 1 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

draft_orders/update

documented from Shopify docs (example)

Draft order changes

Identified by x-shopify-topic header Resource draft_orders

shopify-draft-orders-update.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"
}

Key fields

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

Full schema: 157 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.