Create Shopify connection to implement custom scopes

Integrator.io
1

I need to add additional scopes for a Shopify integration and found a community article (Shopify - Custom GraphQL Connection - Update the Scopes?) that details a custom app needs to be created and given the appropriate scopes.

It appears that Shopify has deprecated the legacy process for creating custom apps and generating an access token

image
image1001Ă—786 92.1 KB

Is there updated documentation to accommodate this change? How can I create a custom connection to add additional scopes?

2

I had to do this a few weeks ago and it was a bit confusing. Hopefully this helps.

Shopify “private apps” are gone — here’s the new way (Custom app + install link)

Shopify replaced the old Private App flow with a custom app that you install via a custom distribution install link. Once installed, you’ll use the app’s Client ID + Client secret as your OAuth credentials in integrator.io.

Video walkthrough (I recorded this end-to-end):

1) Create the app (Shopify Dev Dashboard)

  1. Go to Shopify Dev Dashboard → Apps
  2. Click Create app
  3. Choose Start from Dev Dashboard
  4. Name it → Create

That’s it. Don’t worry about installing yet — you can’t install until you release a version and generate the install link.

2) Add scopes + the integrator.io redirect URL, then release a version

  1. In the app, go to Versions

  2. Open New version (or “Create version”)

  3. Configure:

  4. Click Release (this matters — without releasing, you can’t properly install/authorize)

Tip: Your scopes here should match what you enter later in your integrator.io connection.

3) Generate an install link for the store (Shopify Partners → Custom distribution)

This is the part that replaces “private app install.”

  1. Open Shopify Partners → select your app

  2. Go to Distribution

  3. In Custom distribution:

    • Enter the store domain (example: yourstore.myshopify.com)
    • (Optional) Plus org options if applicable

  4. Click Generate link

  5. Copy the install link

4) Install it on the store

  1. Open the install link while logged into the target store admin
  2. Click Install / Approve

Now the app exists inside that store and can be authorized.

5) Copy the OAuth credentials (Client ID + Secret)

  1. Back in Shopify Dev Dashboard for the app

  2. Go to Settings → Credentials

  3. Copy:

    • Client ID
    • Client secret

6) Configure integrator.io (Custom OAuth) and authorize

In integrator.io:

  1. Create/update your OAuth client (iClient) using:

    • Client ID = Shopify Client ID
    • Client secret = Shopify Client secret

  2. Create/update your Shopify connection (Custom OAuth):

    • Scope: same scopes you set in Shopify (example: read_products)
    • Store: your store domain / store name (depending on your connection UI)

  3. Click Save & authorize

  4. Approve access in Shopify

2 Likes