Tax webhook summary and calculation requests now use Global IDs
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 01, 2026.
This Shopify update is categorized as Action Required, API, Breaking API Change, GraphQL Admin API, Events & webhooks, 2027-01.
What changed
This change affects two key integration points: Tax calculation requests: Customer, Company, CompanyLocation, Product, and ProductVariant IDs now use the GID format. Tax summary webhooks: All entity IDs within the summary section (Order, Customer, Product, ProductVariant, SalesAgreement, Sale, LineItem, Company, CompanyLocation ShippingLine, and TaxLine) now use the GID format. The webhook payload also includes new admin_graphql_api_id fields at the top level for TaxSummary, Shop, and Order entities. Changes include: Top Level: Adds shop_admin_graphql_api_id and order_admin_graphql_api_id fields (existing shop_id and order_id remain as integers). Customer IDs: Changes from "id": "5" to "id": "gid://shopify/Customer/5".
Who is affected
Apps that subscribe to or process Shopify webhooks or event payloads should review this change.
What action may be needed
Update your integrations to handle the GID format when processing tax calculations and webhook payloads in API version 2027-01 and later.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →