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)
orders/create New order created
Identified by x-shopify-topic header
Resource orders
{
"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
orders/updated
documented from Shopify docs (example)
orders/updated Order details change
Identified by x-shopify-topic header
Resource orders
{
"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
orders/paid
documented from Shopify docs (example)
orders/paid Order is paid
Identified by x-shopify-topic header
Resource orders
{
"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
orders/cancelled
documented from Shopify docs (example)
orders/cancelled Order is cancelled
Identified by x-shopify-topic header
Resource orders
{
"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
orders/fulfilled
documented from Shopify docs (example)
orders/fulfilled Order is fulfilled
Identified by x-shopify-topic header
Resource orders
{
"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
order_transactions/create
documented from Shopify docs (example)
order_transactions/create Order transaction succeeds, fails or errors
Identified by x-shopify-topic header
Resource orders
{
"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
orders/delete
documented from Shopify docs (example)
orders/delete Order is deleted
Identified by x-shopify-topic header
Resource orders
{
"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
orders/edited
documented from Shopify docs (example)
orders/edited Order is edited
Identified by x-shopify-topic header
Resource orders
{
"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
orders/link_requested
documented from Shopify docs (example)
orders/link_requested Customer asks for a new link from an expired order status page
Identified by x-shopify-topic header
Resource orders
{
"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"
} Key fields
| 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 |
Full schema: 315 fields.
From Shopify docs
-
Content type
application/json
orders/partially_fulfilled
documented from Shopify docs (example)
orders/partially_fulfilled Order is partially fulfilled
Identified by x-shopify-topic header
Resource orders
{
"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
orders/risk_assessment_changed
documented from Shopify docs (example)
orders/risk_assessment_changed New risk assessment available on an order
Identified by x-shopify-topic header
Resource orders
{
"provider_id": null,
"provider_title": null,
"risk_level": "medium",
"created_at": null
} From Shopify docs
-
Content type
application/json
orders/shopify_protect_eligibility_changed
documented from Shopify docs (example)
orders/shopify_protect_eligibility_changed Order's Shopify Protect eligibility changes
Identified by x-shopify-topic header
Resource orders
{
"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
refunds/create
documented from Shopify docs (example)
refunds/create Refund created on an order, regardless of money movement
Identified by x-shopify-topic header
Resource orders
{
"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
tender_transactions/create
documented from Shopify docs (example)
tender_transactions/create New tender transaction created
Identified by x-shopify-topic header
Resource orders
{
"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
requested_order_edit/created
documented from Shopify docs (example)
requested_order_edit/created Customer requests an edit to an order
Identified by x-shopify-topic header
Resource orders
{
"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
requested_order_edit/declined
documented from Shopify docs (example)
requested_order_edit/declined Requested order edit is declined
Identified by x-shopify-topic header
Resource orders
{
"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
requested_order_edit/resolved
documented from Shopify docs (example)
requested_order_edit/resolved Requested order edit is resolved
Identified by x-shopify-topic header
Resource orders
{
"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
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.