Shopify - Client credentials

Requirements

Before you start, make sure you have the following:

Shopify account permissions:

• You must be the Store Owner or have a Staff account with the proper rights.

• The user must have View access on:
  • Orders → View
  • Customers → View
  • Products → View
  These let the API read the store’s data.

App development permissions:

• App development → View apps developed by staff and collaborators → Develop

• Enable development

• Manage and install apps and channels
  These permissions let the user create and install a Custom App for API access.

Catchr Staff resource:

To configure the Shopify Staff permissions in Shopify, follow the guidance in this help article:
https://help.catchr.io/en/articles/164-create-a-shopify-staff-account-with-the-right-permissions-to-generate-an-api-key-for-catchr

Step 1 — Create a Custom App in Shopify

1. Log in to your Shopify Admin as Owner or Staff with permissions.

2. Go to Settings
   

   

3. Go to Apps in the Shopify admin then click Develop apps
   

   

4. Click Build apps in the Dev Dashboard.
   

   

5. Create a new app
   

   

6. Give it a name like Catchr Connector and click Create.
   

   

7. In URLs → App URL, enter “https://app.catchr.io” and uncheck “Embed app in Shopify admin”
   

   

8. In Access → scopes, paste theses scopes: “read_all_orders,read_orders,read_customers,read_products,read_returns”
   
   ! Note: The read_all_orders scope must be explicitly requested before it can be added to your app.

   How to request the read_all_orders scope?

   1. In your Shopify app settings, click the “Request access” button located above the scopes field.

   2. You will be redirected to the API access requests page. On this page, locate the “Read all orders” section and click “Request access” again.

   3. In the explanation field, asking why your app requires access to older orders, enter: “Read all historical orders data.”

   4. Once access has been granted, go back to the “Versions” screen where you manage your scopes and add the read_all_orders scope (you might have to refresh the page).

   
   Then click Release and give a version name, and click Release again.
   

   

9. Install the app: go back to Home and click Installs
   

   

9. Select the Store where you want to install it.
   

   

10. Click Install (you will be redirected to app.catchr.io (if not, check step 7).
    

    

11. Go back to the tab on dev.shopify.com and go to Settings to find your Client ID and Client Secret. Keep this tab open, you will need these to create your Catchr Source.

Step 2 — Add Shopify Source in Catchr

1. Log in to your Catchr account at https://app.catchr.io.

2. Click Sources in the left menu.

3. Click + Add Source in the top right.

4. Choose Shopify as the platform.

5. Give your new Source a name (e.g., catchr-test.myshopify.com).

6. When prompted:

   • Enter your Shopify store domain (e.g., yourstore.myshopify.com)

   • Paste the Client ID and Client Secret from the App you created.

7. Click Connect to create the source.

Step 3 — Verify and Activate

1. Once connected, Catchr will show your available Shopify account.

2. Activate the source and confirm permissions.

3. You can now use this Shopify Source in Catchr for reporting in Looker Studio, Excel, Google Sheets, Power BI, Tableau, etc.