What’s New in GraphQL Admin API Version 2026-01?
We’re excited to announce that Shopify Flow now uses version 2026-01 of the GraphQL Admin API, bringing powerful updates that enhance automation capabilities for merchants. Let’s explore the key enhancements in this update.
Advanced Querying of Metafields and Metaobjects
The updated API now allows:
- Querying metafields on additional resources, including Companies and Company Locations.
- Expanded queries for Product, Order, and Metaobject metafield values, including greater than/less than comparisons, prefix matching, and boolean operators like AND, OR, and NOT.
These improvements provide greater flexibility and precision in handling data.
Access Transactions on the Return Object
You can now retrieve transaction data directly from the Return object. This enhancement simplifies workflows by allowing direct access to return-related transaction details when using triggers tied to returns.
New Return Reason Definitions
The new ReturnReasonDefinition type helps merchants capture more specific and granular return reasons by category. This replaces the previous ReturnReason field on the Return object in return triggers. Additionally:
- Both the
returnCreateandreturnRequestmutations now accept the new field as input during an Admin API request action.
Phone Field in orderUpdate Mutation
Merchants can now update a customer’s phone number for an order using the orderUpdate mutation. This new phone field overwrites the existing phone number, making it easier to maintain accurate customer contact details during updates.
Learn more about changes introduced in version 2026-01 by visiting the Developer Changelog. You can also explore how Shopify Flow uses the GraphQL Admin API in our documentation.