Shopify checkout webhook events
Shopify sends 5 checkout events, including carts/create, carts/update and checkouts/create.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
carts/create
verified from a captured delivery
carts/create Online store cart created; custom storefront carts excluded
Identified by x-shopify-topic header
Resource checkout
{
"id": "eeafa272cebfd4b22385bc4b645e762c",
"token": "eeafa272cebfd4b22385bc4b645e762c",
"line_items": [ … ],
"note": null,
"updated_at": "2023-02-18T13:43:22.030Z",
"created_at": "2023-02-18T13:43:22.030Z"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | eeafa272cebfd4b22385bc4b645e762c |
updated_at | string | 2023-02-18T13:43:22.030Z |
Full schema: 62 fields.
Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,idempotency-key,x-shopify-api-version,x-shopify-hmac-sha256,x-shopify-shop-domain,x-shopify-topic,x-shopify-trace-context,x-shopify-webhook-id
carts/update
verified from a captured delivery
carts/update Online store cart changes; custom storefront carts excluded
Identified by x-shopify-topic header
Resource checkout
{
"id": "eeafa272cebfd4b22385bc4b645e762c",
"token": "eeafa272cebfd4b22385bc4b645e762c",
"line_items": [ … ],
"note": null,
"updated_at": "2023-02-18T13:48:31.544Z",
"created_at": "2023-02-18T13:48:31.544Z"
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | eeafa272cebfd4b22385bc4b645e762c |
updated_at | string | 2023-02-18T13:48:31.544Z |
Full schema: 62 fields.
Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,idempotency-key,x-shopify-api-version,x-shopify-hmac-sha256,x-shopify-shop-domain,x-shopify-topic,x-shopify-trace-context,x-shopify-webhook-id
checkouts/create
verified from a captured delivery
checkouts/create New checkout created
Identified by x-shopify-topic header
Resource checkout
{
"id": 981820079255243500,
"token": "123123123",
"cart_token": "eeafa272cebfd4b22385bc4b645e762c",
"email": "example@email.com",
"gateway": null,
"buyer_accepts_marketing": false,
"created_at": "2023-02-18T08:49:05-05:00",
"updated_at": "2023-02-18T08:49:05-05:00",
"landing_site": null,
"note": null,
"total_line_items_price": "31.99"
} Key fields
| Field | Type | Example |
|---|---|---|
id | number | 981820079255243500 |
total_line_items_price | string | 31.99 Watch out Numeric string. |
created_at | string | 2023-02-18T08:49:05-05:00 |
Full schema: 167 fields.
Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,idempotency-key,x-shopify-api-version,x-shopify-shop-domain,x-shopify-topic,x-shopify-trace-context,x-shopify-webhook-id
checkouts/delete
verified from a captured delivery
checkouts/delete Checkout is deleted
Identified by x-shopify-topic header
Resource checkout
{
"id": 981820079255243500,
"presentment_currency": "CAD",
"buyer_accepts_sms_marketing": false,
"sms_marketing_phone": null,
"total_discounts": "0.00",
"total_line_items_price": "31.99",
"total_price": "31.99",
"total_tax": "0.00",
"subtotal_price": "31.99",
"total_duties": null
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 981820079255243500 |
total_line_items_price | string | 31.99 Watch out Numeric string. |
Full schema: 12 fields.
Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,x-shopify-api-version,x-shopify-hmac-sha256,x-shopify-shop-domain,x-shopify-topic,x-shopify-trace-context,x-shopify-webhook-id
checkouts/update
verified from a captured delivery
checkouts/update Checkout details change
Identified by x-shopify-topic header
Resource checkout
{
"id": 981820079255243500,
"token": "123123123",
"cart_token": "eeafa272cebfd4b22385bc4b645e762c",
"email": "example@email.com",
"gateway": null,
"buyer_accepts_marketing": false,
"created_at": "2023-02-20T20:27:26-05:00",
"updated_at": "2023-02-20T20:27:26-05:00",
"landing_site": null,
"note": null,
"total_line_items_price": "31.99"
} Key fields
| Field | Type | Example |
|---|---|---|
id | number | 981820079255243500 |
total_line_items_price | string | 31.99 Watch out Numeric string. |
created_at | string | 2023-02-20T20:27:26-05:00 |
Full schema: 167 fields.
Seen in a captured delivery
-
Content type
application/json -
API version
2026-07 -
Headers
user-agent,content-type,x-shopify-api-version,x-shopify-shop-domain,x-shopify-topic,x-shopify-trace-context,x-shopify-webhook-id
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.