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 →

orders/create

documented from Shopify docs (example)

New order created

Identified by x-shopify-topic header Resource orders

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

Key fields

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

Full schema: 315 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/updated

documented from Shopify docs (example)

Order details change

Identified by x-shopify-topic header Resource orders

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

Key fields

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

Full schema: 315 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/paid

documented from Shopify docs (example)

Order is paid

Identified by x-shopify-topic header Resource orders

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

Key fields

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

Full schema: 315 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/cancelled

documented from Shopify docs (example)

Order is cancelled

Identified by x-shopify-topic header Resource orders

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

Key fields

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

Full schema: 315 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/fulfilled

documented from Shopify docs (example)

Order is fulfilled

Identified by x-shopify-topic header Resource orders

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

Key fields

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

Full schema: 315 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

order_transactions/create

documented from Shopify docs (example)

Order transaction succeeds, fails or errors

Identified by x-shopify-topic header Resource orders

shopify-order-transactions-create.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"
}

Key fields

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

Full schema: 42 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/delete

documented from Shopify docs (example)

Order is deleted

Identified by x-shopify-topic header Resource orders

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

Key fields

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

Full schema: 1 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/edited

documented from Shopify docs (example)

Order is edited

Identified by x-shopify-topic header Resource orders

shopify-orders-edited.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": { … }
  }
}

Key fields

Field Type Example
order_edit.id integer 78912328793123780
order_edit.created_at string 2023-02-20T20:50:42-05:00

Full schema: 25 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/partially_fulfilled

documented from Shopify docs (example)

Order is partially fulfilled

Identified by x-shopify-topic header Resource orders

shopify-orders-partially-fulfilled.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"
}

Key fields

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

Full schema: 315 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/risk_assessment_changed

documented from Shopify docs (example)

New risk assessment available on an order

Identified by x-shopify-topic header Resource orders

shopify-orders-risk-assessment-changed.json
{
  "provider_id": null,
  "provider_title": null,
  "risk_level": "medium",
  "created_at": null
}

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

orders/shopify_protect_eligibility_changed

documented from Shopify docs (example)

Order's Shopify Protect eligibility changes

Identified by x-shopify-topic header Resource orders

shopify-orders-shopify-protect-eligibility-changed.json
{
  "order_id": 1,
  "status": "active",
  "eligibility": { … }
}

Key fields

Field Type Example
status string active

Full schema: 4 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

refunds/create

documented from Shopify docs (example)

Refund created on an order, regardless of money movement

Identified by x-shopify-topic header Resource orders

shopify-refunds-create.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": { … }
}

Key fields

Field Type Example
id integer 890088186047892400

Full schema: 114 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

tender_transactions/create

documented from Shopify docs (example)

New tender transaction created

Identified by x-shopify-topic header Resource orders

shopify-tender-transactions-create.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 fields

Field Type Example
id integer 220982911946154500
amount string 36.99 Watch out Numeric string.

Full schema: 10 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

requested_order_edit/created

documented from Shopify docs (example)

Customer requests an edit to an order

Identified by x-shopify-topic header Resource orders

shopify-requested-order-edit-created.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": { … }
}

Key fields

Field Type Example
id integer 963881762
status string requested
requested_at string 2026-01-15T07:00:00-05:00

Full schema: 13 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

requested_order_edit/declined

documented from Shopify docs (example)

Requested order edit is declined

Identified by x-shopify-topic header Resource orders

shopify-requested-order-edit-declined.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": { … }
}

Key fields

Field Type Example
id integer 963881762
status string declined
requested_at string 2026-01-15T07:00:00-05:00

Full schema: 13 fields.

From Shopify docs

  • Content type application/json

Send example to Inspect → View as JSON

requested_order_edit/resolved

documented from Shopify docs (example)

Requested order edit is resolved

Identified by x-shopify-topic header Resource orders

shopify-requested-order-edit-resolved.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": { … }
}

Key fields

Field Type Example
id integer 963881762
status string resolved
requested_at string 2026-01-15T07:00:00-05:00

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.