7/18/2026, 12:00:42 AM
A new set of API features now supports managing inventory purchase orders—including the queries inventoryPurchaseOrder and inventoryPurchaseOrders—and related types for purchase order line items, status, and supplier snapshots. Developers can create, update, or delete inventory bins at a location through the mutations inventoryBinUpsert and inventoryBinDelete, and initiate inventory counts via inventoryCountCreate that audit and adjust stock levels. A new mutation, requestedEditCreate, allows an app to request edits to an order on behalf of a buyer, returning a RequestedEdit payload and error handling. The channel-related API fields (channelDefinitions, channelName, svgIcon, etc.) are deprecated; use the newer orderAttributionDefinitions query and OrderAttributionDefinition type instead. Additional fields on Location (inventoryBins, inventoryLocationItemQuantities) expose bin and aggregated inventory data, and the Shop type gains a marketingEmailConsentEnabledAtCheckout flag. New enum values and a field adaptivePricingEnabled extend market pricing features, and webhook topics REQUESTED_EDITS_CREATE, REQUESTED_EDITS_RESOLVE, and REQUESTED_EDITS_DECLINE are introduced for order edit events.
Returns an InventoryPurchaseOrder object by ID.
Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Returns a paginated list of purchase orders.
Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Returns approved order attribution definitions for the calling app on the current shop.
Learn more in the order attribution guide.
Deletes inventory bins.
Note:
This mutation is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Creates or updates bins at a given location.
Note:
This mutation is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Creates an inventory count for auditing and adjusting stock levels at a specific location.
Note:
This mutation is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Creates a requested edit on an order on behalf of a buyer.
Deletes an order attribution definition for the calling app on the current shop. Existing orders
attributed to this definition are preserved.
Learn more in the order attribution guide.
Upserts an order attribution definition for the calling app on the current shop. Apps can use
attribution definitions to label orders they route to a shop, replacing or augmenting any definitions
shipped declaratively via the order_attribution_config extension.
Learn more in the order attribution guide.
If a definition with the same handle exists for this app on the shop, the supplied input fields are
merged onto it; fields omitted from the input are left unchanged. Otherwise a new definition is
created. To explicitly clear the stored icon on an existing definition, pass icon: null.
A physical container (bin) at a location where inventory is stored.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple InventoryBins.
Return type for inventoryBinDelete mutation.
An error that occurs during the execution of InventoryBinDelete.
Possible error codes that can be returned by InventoryBinDeleteUserError.
An auto-generated type which holds one InventoryBin and a cursor during pagination.
The input fields to create or update a bin at a location.
The quantity of an inventory item stored in a bin.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple InventoryBinItemQuantities.
An auto-generated type which holds one InventoryBinItemQuantity and a cursor during pagination.
Return type for inventoryBinUpsert mutation.
An error that occurs during the execution of InventoryBinUpsert.
Possible error codes that can be returned by InventoryBinUpsertUserError.
Represents an inventory count operation for auditing and adjusting stock levels at a specific location.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Return type for inventoryCountCreate mutation.
An error that occurs during the execution of InventoryCountCreate.
Possible error codes that can be returned by InventoryCountCreateUserError.
Represents an item in an inventory count, including its counted quantities, expected quantities, variance, and review status.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple InventoryCountLineItems.
An auto-generated type which holds one InventoryCountLineItem and a cursor during pagination.
The input fields identifying an item to include in the count, optionally with a starting counted quantity.
The input fields for a submitted counted quantity, paired with the expected on-hand it was counted against.
A purchase order represents an agreement from a merchant to buy goods or services from a supplier.
While the agreement is captured on the merchant's side as a purchase order, it’s recorded as a sales order
on the supplier side.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple InventoryPurchaseOrders.
An auto-generated type which holds one InventoryPurchaseOrder and a cursor during pagination.
Represents a line item belonging to an inventory purchase order.
This is a simplified view of the purchase order line item for inventory management purposes.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple InventoryPurchaseOrderLineItems.
An auto-generated type which holds one InventoryPurchaseOrderLineItem and a cursor during pagination.
The possible statuses an inventory purchase order can have.
Represents an inventory supplier associated with a purchase order.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
Represents a snapshot of the supplier where a purchase order originates from.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
The aggregate quantities of an inventory item at a location, summed across the location's bins.
onHand is the unbinned residual (unbinnedQuantity) plus the quantity held in every bin.available is the location-level sellable quantity. committed is location-level and is not
split per bin.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple LocationItemQuantities.
An auto-generated type which holds one LocationItemQuantity and a cursor during pagination.
The set of valid sort keys for the LocationItemQuantity query.
The set of valid sort keys for the PurchaseOrderLineItem query.
The input fields for creating a requested edit.
The input fields for a line item in a requested edit.
Return type for requestedEditCreate mutation.
Errors related to creating a requested edit.
Possible error codes that can be returned by RequestedEditCreateUserError.
channelDefinitionschannelNamechannelNamehandleidisMarketplacesubChannelNamesvgIconappchannelDefinitionchannelIddisplayNameidchannelIdinventoryBinsA paginated list of inventory bins at this location.
Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
inventoryLocationItemQuantitiesA list of the aggregate inventory quantities, per item, at this location
(summed across the location's bins). Filterable by sku.
Note:
This query is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
ADAPTIVE_PRICING_REQUIRES_LOCAL_CURRENCIESadaptivePricingEnabledWhether adaptive pricing is enabled for the market. Only applicable to Managed Markets and must be ignored otherwise.
channelDefinitionsForInstalledChannelsmarketingEmailConsentEnabledAtCheckoutWhether email marketing has been enabled on the shop's checkout configuration settings.
REQUESTED_EDITS_CREATEREQUESTED_EDITS_RESOLVEREQUESTED_EDITS_DECLINE