V1NodesShopify GraphQL
Shopify GraphQL
V1

Shopify GraphQL

Provides integration with Shopify using the Admin GraphQL API for queries and mutations.

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 used to authenticate against the Shopify Admin GraphQL 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: Secret
The OAuth access token used for Shopify Admin API authentication. Flowgear populates this after you click Connect your Account and complete Shopify authorization.

ClientId
Type: String
The OAuth Client ID. This identifies your app when Flowgear connects to Shopify.

ClientSecret
Type: Secret
The OAuth Client Secret. This is treated like a password and is used with the Client ID to identify your app.

Scope
Type: String
Optional OAuth scopes to request as a comma-separated list, e.g. read_products,write_products,read_companies. Only request the scopes you need, as 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, e.g. product, order, or customer. 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.

ValidateSelectionSet

Type: Boolean Input
When true, validates the selection set against the schema before Query or Mutation runs. Defaults to true.

CustomProperties

Type: Object Input
Additional GraphQL query argument values supplied as key/value pairs. Use dot-path notation for nested query arguments, e.g. items.first. For mutation input fields, use Request.

Remarks

Selection Set Spacing

Use tabs for nested fields in SelectionSet.

Nested Arguments

Nested arguments in queries are supported via dot-path notation, e.g. items.first. The Node generates matching custom properties when you select a sample.

Pagination

Queries automatically handle pageInfo and edges results, so paged data is collected across requests.

Union Types

When SelectionSet uses union or interface types, add inline fragments so Shopify can return the expected fields.

Mutation Errors

Inspect userErrors on mutation responses. Shopify often reports partial failures there instead of as top-level GraphQL errors.

How to Create a Connection

Use the following setup flow to create a Shopify app and connect it in Flowgear.

For further guidance on Shopify custom apps, see Create and Install a Custom Shopify App.

1. Create a Shopify App

  1. Open the Shopify Developer Dashboard: https://dev.shopify.com/dashboard/.
  2. Create a new app (Create App).
  3. Create a new version if prompted.
  4. Give your app a name.

2. Configure API Access

  1. Configure the required Admin API access scopes for what you need (products, orders, customers, and so on).
  2. Set the Redirect URL to: https://app.flowgear.net/r/auth.
  3. Save, release, or apply your changes based on the Shopify UI.
  4. Install the app on your Shopify store.

3. Capture your Credentials

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

4. Connect in Flowgear

  1. In Flowgear, create a new Connection profile.
  2. Fill in:
    • Url: https://{shop}.myshopify.com
    • ApiVersion: e.g. 2026-01
    • ClientId
    • ClientSecret
    • Scope
  3. Click Connect your Account and complete the Shopify authorization prompt.

See Also

This Node wraps the Shopify Admin GraphQL API. Documentation for this API can be found at Shopify GraphQL Admin API Documentation.

ShopifyB2BGraphQL