Complete the following steps to create the Reach Data app in Shopify for the Reach Embedded solution.

✅

Best practice

Shopify's webhooks are versioned to correspond with their API version. We strongly recommend updating your apps, including this Shopify custom app, to use the latest stable API version every quarter. See Use a new API version in the Shopify documentation for instructions on updating the webhook version.

Install a custom API into your Shopify account to ensure smooth reporting and remittance on Reach’s end. Follow these easy steps to complete the process:

Step 1. Allow legacy app development

1. Sign in to Shopify.
2. Click Settings in the lower-left corner of the page, then click Apps and sales channels.
3. Click Develop Apps in the top-right corner of the App and sales channels page.

   

4. From the App development screen, click Allow legacy custom app development.

ℹ️

Note

If your store doesn’t have developer apps, click Allow custom app development to continue. You will see the following screen.

5. Click Allow custom app development.

Step 2. Create the Reach Data app

1. Click Create a legacy custom app.

2. From the Create an app modal, type the app’s name for the settlement in the App name field. We recommend using “Reach Data” as the app name.

3. Click Create app.
4. In the Reach Data page, click the Configuration tab.

5. Click Configure in the Admin API integration section. If you have already configured this integration, you can skip this step.

6. Under Admin API access scopes, use the Filter access scopes field to locate and select the following checkboxes.
   • read_orders
   • read_products
   • read_shopify_payments_payouts
   • read_shopify_payments_disputes
   • read_shopify_payments_accounts
   • read_shopify_payments_bank_accounts

7. Click Save. Your Admin API access scopes will appear under the Admin API integration in the Configuration tab.

8. Click the API credentials tab.

9. Under Access tokens, click Install app to install the application and generate your access tokens.

10. On the Install Reach Data modal, click Install to add it to your store. Your API access token and API keys are now available on the API credentials tab.

11. Reveal, copy, and save the Admin API access token, key, and secret key to a safe place:

⚠️

Important

When saving API keys and tokens, you must store them securely. For example, keep confidential (secret) keys on your servers only and do not store them in version control systems. It helps protect your API keys from unauthorized access.