Shopify Flow and GraphQL Admin API

Flow uses the Shopify GraphQL Admin API to build automations and integrations that extend and enhance the Shopify admin. Flow currently uses version 2024-07 of the API to evaluate conditions and variables in workflows as well as take actions in your Shopify store. Because Flow accesses store data by calling the API, you have access to nearly all the fields available in the API from Flow.

Most actions in Flow use the API to make changes to your Shopify store. For example, the Add order tags action uses the tagsAdd mutation. The Send Admin API request action can use most mutations, including those not yet available as actions in Flow.

As you create workflows, you will often encounter field names and descriptions based on the API. You might need to preview data or review the API documentation to understand what is outputted by the API and used in Flow as well as to ensure that your workflow outputs the data that you expect.

API Versioning

Shopify releases new API versions every three months and Flow adopts new versions as soon as possible, but might be behind the latest version. When possible, changes between versions are resolved automatically but some changes might not be straightforward, including:

• When fields are removed but no replacement is provided, potentially affecting how conditions or Liquid are evaluated.
• When fields become nullable, potentially affecting how conditions or Liquid are evaluated.
• When enum values change or new union or interface types are added, potentially affecting Liquid or code.
• When mutation arguments change, potentially affecting the configuration of Send Admin API request actions.

Some workflows might need to be updated manually. In these cases, workflows might display an Update required or Unsupported API error and guide you to the relevant API documentation to make the required changes in the workflow editor. When these updates are completed and saved, the workflow automatically updates to use the latest API version available in Flow.

You can choose to ignore issues temporarily to make urgent changes to a workflow with API version compatibility errors. If these issues aren't addressed then the workflow might cease to run or cause errors when the older API version is no longer supported by Shopify.