Skip to main content

Shopify

The adapters for Shopify are the result of years of experience as Shopify Partner Plus.

The benefits of our solution:

⚡ Excellent performance for sending data to Shopify.

💸 Integrating Shopify is complex. Instead, you can focus on product data with our simplified APIs.

✅ Deprecated APIs will no longer be a problem. Updates will be automatic and transparent.

💣 Simple JSONs for complex operations. Product creation calls more than 20 Shopify queries and mutations.

Shopify Product Flows​

Steps required to activate a product synchronization flow

Shopify Order Flows​

Steps required to activate an order synchronization flow

How to Create a Custom App Using the Dev Dashboard (New Method)​

To create a new custom app compatible with OAuth / Client Credentials, follow these steps:

  1. Log in to the Dev Dashboard — or, from the Shopify Admin, go to Settings > Apps and sales channels > Develop apps > Build apps in Dev Dashboard.
  2. In the “Apps” section of the Dev Dashboard, click Create app → select Start from Dev Dashboard.
  3. Give the app a name and confirm with Create.
  4. Once the app is created, go to the Versions tab and create a version:
  • set your app URL (if it is not embedded inside the Shopify Admin, you can use the default URL provided by Shopify)
  • select the Webhooks API version (typically the latest available)
  • define the required scopes — the API permissions needed by your integration (inventory, orders, products, locations, etc.)
  • save and Release the created version.
  1. Install the app on your store: in the app’s “Home” section inside the Dev Dashboard, click Install app, select or create the store on which to install it, and confirm with Install.
  2. Authenticate the app using the Client Credentials Grant: retrieve the Client ID and Client Secret from the app created in the Dev Dashboard. These credentials will be necessary to generate a token to be used in API calls (a “shop access token”).

Shopify documentation – Creating custom apps via Dev Dashboard

Authentication​

The integration supports three authentication methods with Shopify:

  1. Access Token Authentication (Legacy - no longer available for new apps after January 1, 2026)
  2. OAuth Authentication (Client ID + Client Secret) — recommended and supported method for new apps.
  3. Offline Access Token Generation via OAuth (Client ID + Client Secret) — allows generating an offline token that does not expire until the app is uninstalled.

You can freely choose which method to use based on your Shopify app configuration. If both methods are provided in the same request, OAuth (Client ID + Client Secret) will take precedence.

Important Note: Starting January 1, 2026, it will no longer be possible to create new legacy custom apps (Access Token). Existing apps will continue to work, but all new integrations must use OAuth authentication.

1. Access Token Authentication (Legacy)​

If the app uses a private Access Token (for example, a token generated under Admin > Apps > Develop apps), simply include it in the request header:

HeaderValueDescription
x-shopify-access-tokenshpat_***************Shopify app access token

2. OAuth Authentication​

If you use OAuth authentication, you must include both the Client ID and Client Secret in the request headers:

HeaderValueDescription
x-shopify-client-id***************Integration app client ID
x-shopify-client-secret***************Integration app client secret

3. Offline Access Token Generation via OAuth​

For new apps created via the Dev Dashboard, you can generate an offline token that does not expire until the app is uninstalled. This token is useful for server-to-server integrations without needing to manage periodic renewals.

Requirements:​

  • The app must be registered via Dev Dashboard.
  • The following are mandatory:
    • clientId
    • clientSecret
    • shopifyShopUrl
  • Scopes are optional; if not provided, all available Shopify scopes will be applied.
  • A redirect endpoint must be registered in the app version (redirectUrls field).

Generation Flow:​

  1. Request the authorization URL:
  • Call the endpoint protected by API Key passing clientId, clientSecret, and shopifyShopUrl.
  • The endpoint returns an authorization URL valid for 5 minutes, which must be opened in a browser.
  • This URL leads to Shopify consent (if needed) or directly to the redirect with the token.
  1. Obtain the token:
  • Once the app is authorized, Shopify redirects to the /oauth/redirect endpoint.
  • The endpoint generates the offline token and returns a JSON response with accessToken.
  • All temporary data is immediately removed for security reasons.

Example Calls:​

Authorization Endpoint

FieldValueNotes
Endpoint{ADAPTER_BASE_URL}/oauth/authorizeReturns an authorization URL valid for 5 minutes
MethodGET—
Headers :: x-api-key***************API key to protect the endpoint
Headers :: x-shopify-client-id***************Integration app Client ID
Headers :: x-shopify-client-secret***************Integration app Client Secret
Headers :: x-shopify-shop-urlhttps://SHOPIFYURL.myshopify.com/Shopify shop URL

Redirect Endpoint

FieldValueNotes
Endpoint{ADAPTER_BASE_URL}/oauth/redirectCallback endpoint that returns the offline token
MethodGET—
Headers / Parameters—All temporary data is immediately removed after token issuance

To use this token in Flowlyze Adapter API calls, include it in the request header:

HeaderValueDescription
x-shopify-access-tokenshpat_***************Shopify app access token

Note: The generated offline token remains valid until the app is uninstalled from the Shopify store.

Metafield Definition​

Register metafields within Shopify Admin -> Settings -> Custom Data

Enter the necessary custom metafields in the "products" group.

tip

Choose metafield types carefully​

Metafields influence both the import and translation process. The metafield type makes it possible or not to create category filters or the presence of HTML.

Shopify Metafields Documentation

Destination​

Configuration of a Shopify destination, which will then be used by other flows to interact with the e-commerce. Download example destination

FieldValueNotes
destination_typeHTTP Adapterintegration adapters work via http
Base Urlhttps://adapter.flowlyze.ioadapter URL
Headers :: x-api-key**********API key for endpoint interaction verification
Headers :: x-shopify-graphql-urlhttps://SHOPIFYURL.myshopify.com/Shopify shop URL to connect to
Headers :: x-shopify-access-tokenshpat_CODICEALFANUMERICOsecret of the custom app created for integration

Shopify Flows​