V1NodesShopify B2B GraphQL
Shopify B2B GraphQL
V1

Shopify B2B GraphQL

Provides integration with Shopify B2B and the Shopify Admin GraphQL API.

Revision History

1.0.0.4 Initial release.
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: Password
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: Password
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.

Remarks

B2B Access

Flowgear refreshes metadata against the Shopify schema and expects to find Company types. If the store does not expose B2B schema types, metadata acquisition fails. Use a Shopify B2B account and include the read_companies Admin API scope.

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 a Connection

Use the below 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). Ensure that you include read_companies for B2B access.
  2. Set the Redirect URL to: https://app.flowgear.net/r/auth.
  3. Select the Webhooks API version if you plan to use webhooks.
  4. Save, release, or apply your changes based on the Shopify UI.
  5. 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. Include read_companies in Scope when you are connecting to a B2B store.
  4. Click Connect your Account and complete the Shopify authorization prompt.

See also

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

Shopify GraphQL