Shopify GraphQL

Help article for the ShopifyGraphQL node that wraps the Shopify Admin GraphQL API.

Revision History

1.0.0.0 Initial Release.
1.0.0.4 Added B2B Node.
1.1.0.0 Resolved selection set issues and enabled nested argument functionality.
1.1.0.1 Fixed validation issue when connection not set.
1.1.1.0 Fixed nested array bug.
1.2.0.0 Added OAuth.

Properties

Connection

Type: Connection Input
The Connection Property for authenticating against the Shopify GraphQL Admin API.

ApiVersion

Type: String
The version of the Shopify GraphQL Admin API to use, e.g., 2026-01.

Url

Type: String
The base URL for your Shopify store. E.g. https://{shop}.myshopify.com

AccessToken

Type: Password
Used for authentication, see https://help.shopify.com/en/manual/apps/app-types/custom-apps#create-and-install-a-custom-app for instructions on how to generate credentials.

ClientId

Type: String
OAuth Client ID. This identifies your app during the OAuth flow.

ClientSecret

Type: Password
OAuth Client Secret (Shopify app “Secret”). This is treated like a password and is used with the Client ID to prove your app’s identity.

Scope

Type: String
Optional OAuth scopes to request as a comma-separated list (e.g. read_products,write_products).
Only request what you need—Shopify will prompt the merchant to approve these permissions during authorization.

Operation

Type: String Input
The GraphQL operation to perform. Options include Query or Mutation. Generated automatically when a sample is selected.

Object

Type: String Input
The Shopify GraphQL object to operate on. For example, product, order, customer, etc. Generated automatically when a sample is selected.

SelectionSet

Type: Multiline Text Input
Defines the fields to retrieve. This is a tab-indented structure where tab depth reflects field nesting. Generated automatically when a sample is selected.

Request

Type: Multiline Text Input
A JSON request defining fields for mutation. Generated automatically, if required, when a sample is selected.

Response

Type: Multiline Text Output
Contains the JSON response received from Shopify.

Remarks

Selection Set Spacing

Use consistent indentation for nested fields in the selection set, either with tabs or four spaces.

Nested Arguments

Nested arguments in queries are supported via dot-path notation (e.g., items.first). The node generates custom properties accordingly when a sample is selected.

How To Create Connection

Below is a practical setup flow for creating a Shopify app and connecting it in Flowgear using OAuth fields (ClientId/ClientSecret).

1 Create a Shopify App

Open the Shopify Developer Dashboard:
https://dev.shopify.com/dashboard/
Create a new app (Create App).
Create a New Version (if prompted).
Give your app a name.

2 Configure API access

Configure the required Admin API access scopes for what you need (products, orders, customers, etc.).
Set the Redirect URL to:
https://app.flowgear.net/r/auth
Select the Webhooks API version (if you plan to use webhooks).
Save / Release / Apply changes (based on Shopify UI).
Install the app on your Shopify store.

3 Capture your credentials

Copy the Client ID and Client Secret from your app credentials screen.
Copy your store URL in the format:
https://{shop}.myshopify.com

4 Connect in Flowgear

In Flowgear, create a new Shopify GraphQL Connection.
Fill in:
- Url: https://{shop}.myshopify.com
- ApiVersion: e.g. 2026-01
- ClientId
- ClientSecret
- Scope (optional, comma-separated)
Click Connect your account and complete the Shopify authorization prompt.