Adding a canceled receive action to the inventory shipments API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 17, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-10.
What changed
Canceled receiving joins the existing accepted and rejected receive actions across the inventory shipments API in version 2026-10. New fields totalCanceledQuantity on InventoryShipment: the total quantity of items marked as canceled across all line items in the shipment, alongside the existing totalAcceptedQuantity and totalRejectedQuantity fields. canceledQuantity on InventoryShipmentLineItem: the quantity of items marked as canceled on a line item, alongside the existing acceptedQuantity and rejectedQuantity fields. Canceled units count toward InventoryShipment.totalReceivedQuantity, so on 2026-10 the received total breaks down fully into accepted, rejected, and canceled. New enum value CANCELED on InventoryShipmentReceiveLineItemReason.
Who is affected
Apps that use the GraphQL Admin API version 2026-10 or later (or unstable) to read inventory shipments, receive shipment line items, or subscribe to the inventory_shipments/receive_items webhook can use the canceled receive action. Apps on versions before 2026-10 aren’t affected. The new fields and enum value aren’t available, webhook payloads keep their current shape, and canceled-only receives stay suppressed for those subscriptions.
What action may be needed
No action is required. To use the canceled receive action: Update your app to API version 2026-10. Query totalCanceledQuantity on InventoryShipment and canceledQuantity on InventoryShipmentLineItem where your app displays or syncs receiving progress. Pass reason: CANCELED to inventoryShipmentReceive when you mark units that won’t arrive.
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 →