---
title: >-
  Removed Checkout ID from checkout and order webhooks - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/removed-checkout-id-from-checkouts-and-orders-webhooks
  md: >-
    https://shopify.dev/changelog/posts/removed-checkout-id-from-checkouts-and-orders-webhooks.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Events & webhooks
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2026-01-29T13:48:14-05:00'
  postedAt: '2026-03-06T17:30:00-05:00'
  updatedAt: '2026-03-06T13:45:17-05:00'
  effectiveAt: '2026-01-30T12:00:00-05:00'
---

March 6, 2026

# Removed Checkout ID from checkout and order webhooks

DateMarch 6, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Events & webhooks](https://shopify.dev/changelog?api_type=webhook)

To simplify and standardize our checkout references, Shopify has removed the following fields from checkout and orders webhooks. Merchants and partners should update their webhook handlers to use the `token` or `checkout_token` fields going forward.

## Checkout webhooks

The `id` field has been removed from the following webhook topics:

* [`checkouts/create`](https://shopify.dev/docs/api/webhooks/latest?accordionItem=webhooks-checkouts-create\&reference=toml)
* [`checkouts/update`](https://shopify.dev/docs/api/webhooks/latest?accordionItem=webhooks-checkouts-update\&reference=toml)

### What you need to do

If you depend on the `id` field , update your infrastructure to use the `token` field instead.

## Orders webhooks

The `checkout_id` field has been removed from the following webhook topics:

* [`orders/cancelled`](https://shopify.dev/docs/api/webhooks/latest?reference=toml\&accordionItem=webhooks-orders-cancelled)
* [`orders/create`](https://shopify.dev/docs/api/webhooks/latest?accordionItem=webhooks-orders-create\&reference=toml)
* [`orders/fulfilled`](https://shopify.dev/docs/api/webhooks/latest?reference=toml\&accordionItem=webhooks-orders-fulfilled)
* [`orders/link_requested`](https://shopify.dev/docs/api/webhooks/latest?reference=toml\&accordionItem=webhooks-orders-link_requested)
* [`orders/paid`](https://shopify.dev/docs/api/webhooks/latest?reference=toml\&accordionItem=webhooks-orders-paid)
* [`orders/partially_fulfilled`](https://shopify.dev/docs/api/webhooks/latest?reference=toml\&accordionItem=webhooks-orders-partially_fulfilled)
* [`orders/updated`](https://shopify.dev/docs/api/webhooks/latest?reference=toml\&accordionItem=webhooks-orders-updated)

### What you need to do

If you depend on the `checkout_id` field, update your infrastructure to use the `checkout_token` field instead.

## Summary

These changes improves consistency across our APIs and ensure that all integrations reference checkouts using the same identifier. Merchants and partners should update their webhook handlers to use the `token` or `checkout_token` fields going forward.

For more details, see the [public webhook documentation](https://shopify.dev/docs/api/webhooks/latest).