---
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/removed-checkout-id-from-checkouts-and-orders-webhooks
  md: >-
    https://shopify.dev/changelog/removed-checkout-id-from-checkouts-and-orders-webhooks.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Webhook
      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

Tags:

* Action Required
* Webhook
* 2026-04

# Removed Checkout ID from checkout and order webhooks

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).