---
updatedAt: 2026-01-08T23:19:18.000Z
agentTools:
  projectIndex: https://docs.withreach.com/llms.txt
---

# Step 1. Configure your Reach API keys

Configure your Reach API key to include settlement data for your Shopify account to ensure smooth reporting and settlement on Reach’s end. Follow these easy steps to complete the process:

1. Sign in to [Shopify](https://www.shopify.com/).
2. Click **Settings** and then click **Apps and sales channels**.

> ℹ️ Note
>
> If your store doesn’t have developer apps, click **Allow custom app development** to continue. You will see the following screen.
>
> <Image align="center" alt="Click **Allow custom app development**" border={false} caption="Click **Allow custom app development**" src="https://files.readme.io/c7d20135975115eab3d2dd60cd96e081e81c3a496c0b6224d09ca97a8bb8e476-Allow_custom_app_development.png" />
>
> Click **Allow custom app development** again.

3. Click **Develop Apps** in the top-right corner of the **App and sales channels** page.

<Image align="center" alt="Click **Develop Apps**" border={false} caption="Click **Develop Apps**" src="https://files.readme.io/9ac49aebfbfed4242e88abefaef1b027e07134237599980cc17697b418b5a4a5-Develop_apps.png" width="95% " />

4. From the **App development** screen, click **Create an app**.

<Image align="center" alt="Click **Create an app**" border={false} caption="Click **Create an app**" src="https://files.readme.io/45a11bf9d6af5bca0b1815966988ad47cbe22b53f144429198dc3b80e6878263-App_development.png" />

5. 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.

<Image align="center" alt="Enter the app's name in the **App name** field" border={false} caption="Enter the app's name in the **App name** field" src="https://files.readme.io/2d6a065a7ad510d4d7585f955dde5d54e6f791582ab57bad1b42b3d59ba7832d-Create_an_app.png" />

6. Click **Create app**.
7. Click **Reach Data** on the **App development** page.

<Image align="center" alt="Click **Reach Data**" border={false} caption="Click **Reach Data**" src="https://files.readme.io/9be3cd927967d1b6fb71e683c11c26a2419a601b2b21c602627503d8fc2c942a-Legacy_custom_apps.png" />

8. From the **Overview** tab on the **Reach Data** page, click the **Configuration** tab.

<Image align="center" border={false} caption="Click the **Configuration** tab" src="https://files.readme.io/a3a5208c6e511e94c3c6e69a51d37313cd1248849447370fa00f09d24f1b4e02-Configuration_tab.png" />

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

<Image align="center" border={false} caption="Click **Configure**" src="https://files.readme.io/8852d5b9cad31927be6df62495af9652093cd062e72b62bd28c457cbca19035c-Admin_API_integration_-_configured.png" />

10. Under **Admin API access scopes**, use the **Filter access scopes** field to locate and select the following checkboxes.
    1. read\_orders
    2. read\_assigned\_fulfillment\_orders
    3. read\_merchant\_managed\_fulfillment\_orders
    4. read\_third\_party\_fulfillment\_orders
    5. read\_locations
    6. read\_products
    7. read\_shopify\_payments\_payouts
    8. read\_shopify\_payments\_disputes
    9. read\_shopify\_payments\_accounts
    10. read\_shopify\_payments\_bank\_accounts

<Image align="center" alt="Use the **Filter access scopes** field to locate checkboxes" border={false} caption="Use the **Filter access scopes** field to locate checkboxes" src="https://files.readme.io/298a4f443819be8ff3a5bb6e6ea2a26622de27b079fe82f40fb1ee235ccd336f-Admin_API_access_scopes.png" />

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

<Image align="center" alt=" API access scopes will appear under the **Admin API integration**" border={false} caption="API access scopes will appear under **Admin API integration**" src="https://files.readme.io/a9682e79150251362c0755661b5a08ed0daf8adfd4f9c9ff177064edc4d1b573-Admin_API_access_scopes_on_Configuration_tab.png" />

12. Click **Edit** in the **Admin API integration** section.
13. Scroll down to **webhook subscriptions** on the **Configuration** tab.
14. Click the **Event version** dropdown and select **2025-07**.
    <Image align="center" border={false} caption="Select **2025-07** from the **Event version** dropdown" src="https://files.readme.io/fcaf35b4bb3bbc40cf2f145d4478da23f24c543130696725c996a5a42b0c23e4-Webhook_subscriptions.png" />
15. Click **API credentials**.
16. Click **Install app** under **Access tokens** to install the application and generate your access tokens.

<Image align="center" alt="Click **Install app**" border={false} caption="Click **Install app**" src="https://files.readme.io/b155172d28dce1a04345db6e65219a79f729a4ee15281cdaec311dc3707ecdf0-Reach_Data_Install_Access_tokens_Install_app.png" />

17. 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.

<Image align="center" alt="Click **Install**" border={false} caption="Click **Install**" src="https://files.readme.io/37efdb494f4a89adde2b04946c7bdad14f054f6c7d374a2b7bf56877b6c3757d-Install_Reach_Data.png" />

18. Reveal, copy, and save the following keys to a safe place:

* **Admin API access token**: To protect your data, you can only reveal and copy your Admin API token once.
* **API key**
* **API secret key**

> ❗️ 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.

<Image align="center" alt="Reveal and copy your keys to a safe place" border={false} caption="Reveal and copy your keys to a safe place" src="https://files.readme.io/a47b35aa5b5ae139ac779da862abb25dd8a774f821888fba472427b0bc07a1d0-API_credentials.png" />

19. Reach will ask you to upload these keys to a secure location. Reach uses these keys to pull the orders and add them to their database.

<br />

Configure your Reach API key to include settlement data for your Shopify account to ensure smooth reporting and settlement on Reach’s end. Follow these easy steps to complete the process:

1. Sign in to [Shopify](https://www.shopify.com/).
2. Click Settings in the lower left corner and then click **Apps and sales channels**.

> ℹ️ Note
>
> If your store doesn’t have developer apps, click **Allow custom app development** to continue. You will see the following screen.
>
> <Image align="center" alt="Click **Allow custom app development**" border={false} caption="Click **Allow custom app development**" src="https://files.readme.io/2a71cf171924796f0259ac20a9a4e158f1c63744690794dadd0164cdd13c85e5-Allow_customer_app_development.png" />
>
> Click **Allow custom app development** again.

3. Click **Develop apps** in the top-right corner of the **App and sales channels** page.

<Image align="center" alt="Click **Develop apps**" border={false} caption="Click **Develop apps**" src="https://files.readme.io/aa14410467d705c4b1d679eb3b493bd162fa4c360e18d3001c4daced65f45dd5-Apps_and_sales_channels.png" />

5. From the **App development** screen, click **Create an app**.

<Image align="center" alt="Click **Create an app**" border={false} caption="Click **Create an app**" src="https://files.readme.io/47d6d0d6e47cfe7bf160592e0cf6b1b7b674020c04ce04239e55de0c07dd2c28-App_development.png" />

6. 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.

<Image align="center" alt="Click **Create app**" border={false} caption="Click **Create app**" src="https://files.readme.io/962722477849f5817fdfd172389f0df33cbbf8888e38567604d0c46147e8d9ba-Create_an_app.png" />

7. Click **Create app**.
8. Click **Reach Data** on the **App development** page.

<Image align="center" alt="Click **Reach Data**" border={false} caption="Click **Reach Data**" src="https://files.readme.io/ea59f0d7d96debbb050296209f331101d10d4ed03b20d01d48636f6092a26ed2-Reach_Data.png" />

9. From the **Overview** tab on the **Reach Data** page, click the **Configuration** tab.
10. Click **Configure** in the **Admin API integration** section. If you have already configured this integration, you can skip this step.
11. 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

<Image align="center" alt="Use the **Filter access scopes** field to locate checkboxes" border={false} caption="Use the **Filter access scopes** field to locate checkboxes" src="https://files.readme.io/298a4f443819be8ff3a5bb6e6ea2a26622de27b079fe82f40fb1ee235ccd336f-Admin_API_access_scopes.png" />

12. Click **Save**. Your Admin API access scopes will appear under the **Admin API itegration** section in the **Configuration** tab.

<Image align="center" alt="Admin API access scopes will appear under the **Admin API itegration**" border={false} caption="Admin API access scopes will appear under the **Admin API itegration**" src="https://files.readme.io/7897a7adb53881b912a27e4a200bd29d802e35d7257f6d4d259a3ad450793e03-Admin_API_access_scopes_on_Configuration_tab.png" />

13. Click **API credentials**.
14. Click **Install app** under **Access tokens** to install the application and generate your access tokens.

<Image align="center" alt="Click **Install app**" border={false} caption="Click **Install app**" src="https://files.readme.io/b155172d28dce1a04345db6e65219a79f729a4ee15281cdaec311dc3707ecdf0-Reach_Data_Install_Access_tokens_Install_app.png" />

15. 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.

<Image align="center" alt="Click **Install**" border={false} caption="Click **Install**" src="https://files.readme.io/37efdb494f4a89adde2b04946c7bdad14f054f6c7d374a2b7bf56877b6c3757d-Install_Reach_Data.png" />

16. Reveal, copy, and save the following keys to a safe place:

    * **Admin API access token**: To protect your data, you can only reveal and copy your Admin API token once.

    * **API key**

    * **API secret key**

    > ❗️ 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.

<Image align="center" alt="Reveal, copy, and save the following keys to a safe place" border={false} caption="Reveal, copy, and save the following keys to a safe place" src="https://files.readme.io/a47b35aa5b5ae139ac779da862abb25dd8a774f821888fba472427b0bc07a1d0-API_credentials.png" />

17. Reach will ask you to upload these keys to a secure location. Reach uses these keys to pull the orders and add them to their database.