Documentation

Shopify GraphQL

Updated on

Jan 27, 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.

Step 1. 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.

Step 2. Click on the Shopify GraphQL tile.

Step 3. Choose authorization option:

{%docs-accordion title="Connect your own Shopify App (recommended)"%}

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.

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

Step 3.2. Click Allow custom app development.

Step 3.3. Click Allow legacy custom app development.

Step 3.4. Click Create a legacy custom app.

Step 3.5. Enter your App name, and click Create app.

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

Step 3.7. Select the following permission scopes:

Access scope name Permission
read_products View products, variants, and collections
read_customers View customers, customer addresses, order history, and customer groups
read_orders View orders, transactions, fulfillments, abandoned checkouts and refunds
read_inventory View inventory across multiple locations
read_shopify_payments 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

Step 3.8. Go to API credentials tab and press Install app.

Step 3.9. Confirm installation by clicking Install.

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

{%docs-accordion-end%}

{%docs-accordion title="OAuth"%}

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

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

Step 3.3. 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_orders View orders, transactions, fulfillments, abandoned checkouts and refunds
read_inventory View inventory across multiple locations
read_shopify_payments 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

{%docs-accordion-end%}

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

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

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

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

Schema information

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

Settings

No items found.

Troubleshooting

Troubleshooting guides

Check out troubleshooting guides for
Shopify GraphQL
here:

Limits

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

Frequently asked questions

No items found.
☶ On this page
Description
Related articles
No items found.
No items found.

Questions?

Improvado team is always happy to help with any other questions you might have! Send us an email.

Contact your Customer Success Manager or raise a request in Improvado Service Desk.