Improvado
Esc

Start typing to search.

Improvado
Sign In

Shopify GraphQL

Updated on Jun 26, 2026

Description‍

Shopify GraphQL is an eCommerce platform that allows users to set up an online store and sell products or services directly to their customers.

Setup guide

Follow our setup guide to connect Shopify GraphQL to Improvado.

Click the Make a new Connection on the Connections page.
‍‍Categories on the Data sources page group all available platforms. Use a search to find the required one.

Click on the Shopify GraphQL tile.

Choose authorization option:

Connect your own Shopify App (via Client Credentials, recommended)

To authorize your account you need to fill in the required fields below following steps 3.1 - 3.4:

  • Shop name
  • Client ID
  • Client Secret

To do these steps you need to have at least Apps Developer role or ask the user with that permission to follow through.

Note
Collaborators don't have access to the Dev Dashboard.

Create a new app from your Dev Dashboard.

  1. From the Dev Dashboard, be sure you're on Apps in the left-panel navigation and select Create app in the top, right corner of the screen.
  2. Select Start from Dev Dashboard.
  3. Name your app, then select Create.

Create a version.

Once you've created the app, you can create a version. Your app must have at least one version before it can be installed on a store.

From the Versions tab of your app in the Dev Dashboard, complete your desired fields, including:

  1. Defining your app URL. Use the default URL https://shopify.dev/apps/default-app-home
  2. Selecting a Webhooks API version (newest version).
  3. Selecting your app scopes. These define the data and features your app can access within the Shopify platform.
Access scope name Permission
read_products View products, variants, and collections
read_customers View customers, customer addresses, order history, and customer groups
read_all_orders View all orders, transactions, fulfillments, abandoned checkouts and refunds. How to obtain this permission
read_orders View orders created within the last 60 days. Required for read_all_orders to function.
read_locations View locations and their properties
read_shopify_payments_payouts View Shopify Payments payouts and the account's current balance
read_returns View information related to order returns
read_gift_cards View information related to gift cards
  1. Select Release.

Complete the following steps to install your app on a store:

  1. From your app, select Home in the left panel of the Dev Dashboard.
  2. Scroll down and select Install app.
  3. Select or create the store for your app.
  4. Select Install.

Your app is now installed.

Copy Client ID and Client secret

Shop data is accessed via client credentials grant:

  1. From your app in the Dev Dashboard, select Settings.
  2. Copy your Client ID and Client secret.
  3. Paste these credentials to Authorization page in Improvado UI.
__wf_reserved_inherit

Connect your own Shopify App (via Access Token, legacy)

To authorize your account you need to fill in the required fields below following steps 3.1 - 3.10:

  • Shop name
  • Admin API access token

To do these steps you need to have Develop apps permission or ask the user with that permission to follow through.
‍

In Shopify Admin, click Apps, and then click Develop apps to create your app.

__wf_reserved_inherit

Click Allow custom app development.

__wf_reserved_inherit

Click Allow legacy custom app development.

__wf_reserved_inherit

Click Create a legacy custom app.

__wf_reserved_inherit

Enter your App name, and click Create app.

__wf_reserved_inherit

After app is created, go to Configuration tab and press Configure for Admin API Integration.

__wf_reserved_inherit

Select the following permission scopes:

__wf_reserved_inherit

‍

Access scope name Permission
read_products View products, variants, and collections
read_customers View customers, customer addresses, order history, and customer groups
read_all_orders View all orders, transactions, fulfillments, abandoned checkouts and refunds. How to obtain this permission
read_orders View orders created within the last 60 days. Required for read_all_orders to function.
read_locations View locations and their properties
read_shopify_payments_payouts View Shopify Payments payouts and the account’s current balance
read_returns View information related to order returns
read_gift_cards View information related to gift cards

Go to API credentials tab and press Install app.

__wf_reserved_inherit

‍

Confirm installation by clicking Install.

__wf_reserved_inherit

Once app is installed, click on Reveal token once to copy and paste to Improvado authorization form.

__wf_reserved_inherit

OAuth

Before authorization, please ensure you are signed in to the account you want to extract data from.

To authorize your account you need to fill in Shop name field. Please use the same shop name from your shop URL, for example, <strong>my-shop-name</strong> if your URL is https://<strong>my-shop-name</strong>.myshopify.com

The following access scopes will be requested during OAuth authorization:

Access scope name Permission
read_products View products, variants, and collections
read_customers View customers, customer addresses, order history, and customer groups
read_all_orders View all orders, transactions, fulfillments, abandoned checkouts and refunds. How to obtain this permission
read_orders View orders created within the last 60 days. Required for read_all_orders to function.
read_locations View locations and their properties
read_shopify_payments_payouts View Shopify Payments payouts and the account’s current balance
read_returns View information related to order returns
read_gift_cards View information related to gift cards

Also, you can find the additional information and in-depth step-by-step guide at the links here:

After the connection process is completed successfully, the Shopify GraphQL connection will appear in your Connected sources list.

When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.

__wf_reserved_inherit

To extract data from the connected sources, check the instruction on how to set up data extraction.

How to obtain read_all_orders permission:

The read_all_orders scope allows access to orders older than 60 days. It requires an additional approval step in the Shopify Partners dashboard before it can be added to your app scopes.

  1. Go to https://partners.shopify.com/YOUR_ORGANIZATION_ID/apps
  2. Click on your app.
  3. Select the API access requests tab (you'll be redirected to https://partners.shopify.com/YOUR_ORGANIZATION_ID/apps/YOUR_APP_ID/api_access).
  4. Under "Read all orders scope," click Request access.
  5. Enter the following reason: "Merchant requires requesting data for orders older than 60 days."
  6. Click Request access.

Scope should be granted immediately and can be added to your app scopes.

Schema information

The schema information shows all report types you can use to extract data from Shopify GraphQL.

Release notes

You can find information about the latest API changes in the official Release notes.

Was this article helpful?