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

Online store cart created; custom storefront carts excluded

Identified by x-shopify-topic header Resource checkout

shopify-carts-create.json
{
  "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

Send example to Inspect → View as JSON

carts/update

verified from a captured delivery

Online store cart changes; custom storefront carts excluded

Identified by x-shopify-topic header Resource checkout

shopify-carts-update.json
{
  "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

Send example to Inspect → View as JSON

checkouts/create

verified from a captured delivery

New checkout created

Identified by x-shopify-topic header Resource checkout

shopify-checkouts-create.json
{
  "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

Send example to Inspect → View as JSON

checkouts/delete

verified from a captured delivery

Checkout is deleted

Identified by x-shopify-topic header Resource checkout

shopify-checkouts-delete.json
{
  "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

Send example to Inspect → View as JSON

checkouts/update

verified from a captured delivery

Checkout details change

Identified by x-shopify-topic header Resource checkout

shopify-checkouts-update.json
{
  "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

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.