> For the complete documentation index, see [llms.txt](https://guide.hypercape.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.hypercape.com/connect-shopify-guide/how-to-connect-shopify.md).

# How to Connect Shopify

{% hint style="success" %}
This guide will help you connect your Shopify store to Hypercape using the Dev Dashboard App method.
{% endhint %}

### Steps

#### 1. Log in to Hypercape BIZ

<figure><img src="https://3720355098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FXa9bBaum5Lf1yHUvzOv4%2F01-login.png?alt=media&#x26;token=c130fe7e-ff2c-4951-b2c8-34979cea8ebe" alt="Log in to Hypercape BIZ"><figcaption><p>Log in to your Hypercape BIZ account at <a href="https://biz.hypercape.com">biz.hypercape.com</a>. Enter your email address and password, then click "Sign in". You can also sign in with your Google account.</p></figcaption></figure>

#### 2. Navigate to Setup

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2F10QfsJjM7htJ0pR9Aiaw%2F02-open-setup.png?alt=media&#x26;token=af69a01b-8fbe-44ac-b5a6-e7406197a3d0" alt="Navigate to Setup"><figcaption><p>After logging in, navigate to the left sidebar and click on "Setup".</p></figcaption></figure>

#### 3. Setup Page

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FYoW7JNyHKdP7kJrQ3e7C%2F03-setup-page.png?alt=media&#x26;token=3b5586c0-3937-4484-8e3b-dcf74c814bb0" alt="Hypercape BIZ Setup page"><figcaption><p>On the Setup page, you'll need your Shop domain along with your Shopify store's Client ID and Client Secret to connect your Shopify account. To find this information, go to your Shopify admin page.</p></figcaption></figure>

#### 4. Open Shopify Admin Site

<figure><img src="https://3720355098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FarDCaUi0o9lJtwkOtjbH%2F04-shopify-admin.png?alt=media&#x26;token=0833d3c1-1e55-49f6-adac-e63057a2827f" alt="Open Shopify Admin"><figcaption><p>Go to your Shopify admin site at <a href="https://admin.shopify.com/">admin.shopify.com</a>.</p></figcaption></figure>

#### 5. Access Dev Dashboard

Go to your Shopify admin site and follow these steps:

1. Click **Settings** at the bottom left.
2. In the left-hand menu, click **Apps**.
3. On the Apps page, click **Develop apps** in the top right.
4. Click **Build apps in Dev Dashboard**.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FvFTgMOg9bGfAiSR8BHFw%2F05a-shopify-settings.png?alt=media&#x26;token=03434ab0-6da2-4d8b-9285-150bb709a4ae" alt="Open Shopify Settings"><figcaption><p>Click "Settings" at the bottom left of Shopify Admin.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FSDBjNZo6PlB3CcQUo6hP%2F05b-shopify-apps-menu.png?alt=media&#x26;token=0ba3c293-b8a7-4d19-97e2-b97ce2a52169" alt="Open Apps menu"><figcaption><p>Open "Apps" from the Settings menu.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2Ff6FdQJGDWqBP3Qh7nwYy%2F05c-develop-apps.png?alt=media&#x26;token=51802c37-c76c-4279-b51e-e83e73eac3fa" alt="Open Develop apps"><figcaption><p>Click "Develop apps" in the top right.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2Fvsf0k1rHdfGRvxQDQCic%2F05d-build-apps-dev-dashboard.png?alt=media&#x26;token=8476590c-73a2-479d-b1e0-e704778d347f" alt="Build apps in Dev Dashboard"><figcaption><p>Click "Build apps in Dev Dashboard".</p></figcaption></figure>

#### 6. Click Create App

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FvsI35fJDOK2nOPqwvHMl%2F06-create-app.png?alt=media&#x26;token=8d065cbf-6354-46cd-a8d1-44a9d7a20f98" alt="Click Create app"><figcaption><p>On the Dev Dashboard page, click "Create app" in the top right corner.</p></figcaption></figure>

#### 7. Enter App Name

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2F18i9HvcNKhPTvn6OuycE%2F07-enter-app-name.png?alt=media&#x26;token=cd44a53a-0ad8-49b1-8a0b-335cbbcfccaf" alt="Enter app name"><figcaption><p>Enter your desired app name (e.g., "hypercape") and click the "Create" button.</p></figcaption></figure>

#### 8. Configure API Scopes

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2Fwf02GETFrZecMAXtL4VH%2F08-configure-api-scopes.png?alt=media&#x26;token=df7200de-4609-4ff6-8afa-2b20dfc3dccb" alt="Configure API scopes"><figcaption><p>After your app is created, you'll be taken to the app configuration page. Scroll down to the "Access" section and click "Select scopes" to configure the API permissions.</p></figcaption></figure>

{% hint style="info" %}
These scopes define exactly which parts of your store Hypercape can access — Hypercape can never access anything outside the scopes you approve here.
{% endhint %}

#### 9. Select Required Scopes

In the "Select scopes" modal, search and enable the following Admin API scopes:

* **Products**: `read_products`, `write_products`
* **Order editing**: `read_order_edits`, `write_order_edits`
* **Orders**: `read_orders`, `write_orders`
* **Fulfillment services**: `read_fulfillments`, `write_fulfillments`
* **Merchant managed fulfillment**: `read_merchant_managed_fulfillment_orders`, `write_merchant_managed_fulfillment_orders`
* **Third party fulfillment**: `read_third_party_fulfillment_orders`, `write_third_party_fulfillment_orders`
* **Custom fulfillment services**: `read_custom_fulfillment_services`, `write_custom_fulfillment_services`
* **Assigned fulfillment**: `read_assigned_fulfillment_orders`, `write_assigned_fulfillment_orders`

Click "Done" after selecting all scopes.

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial10.png" alt="Select Products Scope"><figcaption><p>Select the Products scope: <code>read_products</code>, <code>write_products</code>.</p></figcaption></figure>

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial11.png" alt="Select Order Editing Scope"><figcaption><p>Select the Order editing scope: <code>read_order_edits</code>, <code>write_order_edits</code>.</p></figcaption></figure>

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial12.png" alt="Select Orders Scope"><figcaption><p>Select the Orders scope: <code>read_orders</code>, <code>write_orders</code>.</p></figcaption></figure>

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial12_1.png" alt="Select Fulfillment Scopes"><figcaption><p>Select fulfillment-related scopes as shown in the modal.</p></figcaption></figure>

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial12_2.png" alt="Select Custom Fulfillment Services Scope"><figcaption><p>Select the Custom fulfillment services scope: <code>read_custom_fulfillment_services</code>, <code>write_custom_fulfillment_services</code>.</p></figcaption></figure>

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial12_3.png" alt="Select Assigned Fulfillment Scope"><figcaption><p>Select the Assigned fulfillment scope: <code>read_assigned_fulfillment_orders</code>, <code>write_assigned_fulfillment_orders</code>.</p></figcaption></figure>

{% hint style="warning" %}

#### For Existing Users: How to Update Permissions

If you already have a connected store and need to update your app permissions, follow these steps:

1. Go to Shopify Settings → Apps and sales channels
2. Click **Develop apps** in the top right corner
3. Select the **HYPERCAPE app** (or your custom app name)
4. Click **Configure Admin API scopes**
5. Enable ALL of the following permissions:

* Assigned fulfillment orders (read & write)
* Custom fulfillment services (read & write)
* Fulfillment services (read & write)
* Merchant-managed fulfillment orders (read & write)
* Orders (read & write)
* Third-party fulfillment orders (read & write)

**⚠️ You must manually grant all 6 permissions above in your Shopify admin panel.**
{% endhint %}

#### 10. Release Your App

After configuring your scopes, scroll down to the bottom of the page and click the "Release" button to publish your app version with the selected permissions.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FAxX8F1StvhAhs8zpmpv2%2F10a-release-app.png?alt=media&#x26;token=f4002255-9130-4e48-a4b5-4ee5746fa07b" alt="Release the app"><figcaption><p>Click "Release" after configuring the required API scopes.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2F1YhA0KoM4KjtKv7Xpipn%2F10b-release-version.png?alt=media&#x26;token=eb8b4467-ccf8-4199-b7f7-0b2419a3a6a9" alt="Release app version"><figcaption><p>Confirm the release to publish the app version with the selected permissions.</p></figcaption></figure>

#### 11. Install App to Your Store

After releasing your app, install it on your Shopify store. In the "Overview" section, click the "Install app" button. A confirmation dialog will show the permissions your app needs; click "Install" to complete the installation.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FI59kjelS4yWEu5qNYFtR%2F11a-active-version.png?alt=media&#x26;token=9217232a-07d4-43d1-baa1-654ecd6b5703" alt="Open the active app version"><figcaption><p>Open the active version of your released app.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FxL1zq52vBtA56ulJN7WY%2F11b-install-app-button.png?alt=media&#x26;token=97163bc9-d0e0-4f14-aa17-39ca51582377" alt="Click Install app"><figcaption><p>Click the "Install app" button.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FcbJu7igeTfbjZxNsJxzy%2F11c-select-store.png?alt=media&#x26;token=dff1e6b6-f642-47c2-8182-4eda151940ed" alt="Select a Shopify store"><figcaption><p>Select the Shopify store where you want to install the app.</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FcMZdHhFEdyDVPbveqkPT%2F11d-confirm-install.png?alt=media&#x26;token=9687b0d1-de53-4191-aaac-88cad5d7ec72" alt="Confirm app installation"><figcaption><p>Review the requested permissions and click "Install".</p></figcaption></figure>

{% hint style="info" %}
Installing the app only grants Hypercape the permissions you configured. This does not complete the connection yet — you will finish connecting on the Hypercape BIZ Setup page in Step 14. You do not need to open or use the app itself.
{% endhint %}

#### 12. Go to Settings

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FOAXnDOlMKgMVwR65cL3B%2F12-go-to-settings.png?alt=media&#x26;token=f5da8ac2-cf54-48b8-b94f-325a9e9fb4e7" alt="Go to app Settings"><figcaption><p>Navigate to the "Settings" tab in the left sidebar.</p></figcaption></figure>

#### 13. Copy Your Credentials

<figure><img src="https://3720355098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2F3JRyBO52wpT3NeHZC6Wd%2F13-copy-credentials.png?alt=media&#x26;token=945df72c-7876-4d5c-8281-a26c4b207c48" alt="Copy Client ID and Client Secret"><figcaption><p>In the Settings page, you'll find the "Credentials" section containing your Client ID and Client Secret. Click the copy icon next to each field to copy these values.</p></figcaption></figure>

{% hint style="info" %}
These two values are what actually connect your store to Hypercape — the app itself is not used after this point.
{% endhint %}

#### 14. Enter Your Credentials

<figure><img src="https://3720355098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FpS0OmQjH1us48adpVLjt%2F14-enter-credentials.png?alt=media&#x26;token=1c05ab0e-bc75-45ef-9a78-f92313ca9ef2" alt="Enter Shopify credentials in Hypercape BIZ"><figcaption><p>Return to the Hypercape BIZ "Setup" page. Paste your copied Client ID and Client Secret into the corresponding fields. Enter your Shopify store URL (the part before <code>.myshopify.com</code>). Click "Save Shopify connection" to complete the connection.</p></figcaption></figure>

#### 15. Connection Complete!

<figure><img src="https://3720355098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKmVnLoHDk5ZkU3shqZqa%2Fuploads%2FUMexZOxCzYWXpXhLBOJH%2F15-connection-complete.png?alt=media&#x26;token=0a61696d-0d53-4344-9aab-573e2fb26dd5" alt="Shopify connection complete"><figcaption><p>If you see the screen below with your store name listed, congratulations! Your Shopify store has been successfully connected to Hypercape. You can now start importing and managing products.</p></figcaption></figure>

{% hint style="info" %}
Need help?

If you encounter any issues during the setup process, contact us at <help@hypercape.com>.
{% endhint %}