Buy Shipping Labels with the GraphQL Admin API
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on June 17, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-07.
What changed
New shippingLabelPurchase mutation in the GraphQL Admin API The GraphQL Admin API now includes the shippingLabelPurchase mutation, which lets apps purchase Shopify Shipping labels for eligible fulfillment orders. Apps can provide the fulfillment order, shipping date and time, package details, total weight, customer notification preference, and optional preferred carrier/service selection. If a preferred rate isn't provided, Shopify selects the cheapest available rate. Label purchase runs asynchronously. The mutation returns a ShippingLabelPurchaseResult, which apps can poll to track the request status: PENDING_PURCHASE: the purchase is still processing.
Who is affected
Apps using the affected Shopify GraphQL API surface should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
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 →