> 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/step-1.-connect-shopify.md).

# Step 1. 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://biz.hypercape.com/static/images/faq/tutorial1.png" alt="Hypercape BIZ Login"><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 Shopify Home

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial2.png" alt="Navigate to Shopify Home"><figcaption><p>After logging in, navigate to the left sidebar and click on \"Shopify\" to expand the menu. Then select \"Home\" from the submenu.</p></figcaption></figure>

#### 3. Click Connect a Store

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial3.png" alt="Click Connect a Store"><figcaption><p>On the Shopify Home page, click the green \"Connect a store\" button to begin connecting your Shopify store to Hypercape.</p></figcaption></figure>

#### 4. Go to Shopify Admin

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial4.png" alt="Go to Shopify Admin"><figcaption><p>A modal window will appear asking for your Shopify credentials. Keep this window open and navigate to your Shopify Admin at <a href="https://admin.shopify.com/">admin.shopify.com</a> in a new browser tab.</p></figcaption></figure>

#### 5. Open Account Menu

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial5.png" alt="Open Account Menu"><figcaption><p>In your Shopify Admin dashboard, click on your account name in the top right corner of the screen to open the account menu.</p></figcaption></figure>

#### 6. Access Dev Dashboard

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial6.png" alt="Access Dev Dashboard"><figcaption><p>From the dropdown menu, click on \"Dev Dashboard\" to access the Shopify Developer Dashboard where you can create and manage your apps.</p></figcaption></figure>

#### 7. Click Create App

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial7.png" alt="Click Create App"><figcaption><p>In the Dev Dashboard, click the \"Create app\" button in the top right corner.</p></figcaption></figure>

#### 8. Enter App Name

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial8.png" alt="Enter App Name"><figcaption><p>On the \"Create an app\" page, in the \"Start from Dev Dashboard\" section on the right, enter your desired app name (e.g., \"hypercape\") and click the \"Create\" button.</p></figcaption></figure>

#### 9. Configure API Scopes

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial9.png" 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>

#### 10. 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 %}

#### 11. Release Your App

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial13.png" alt="Release Your App"><figcaption><p>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.</p></figcaption></figure>

#### 12. Install App to Your Store

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial18.png" alt="Click Install App Button"><figcaption><p>In the \"Overview\" section, click the <strong>Install app</strong> button.</p></figcaption></figure>

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial19.png" alt="Confirm Installation"><figcaption><p>A confirmation dialog will appear showing the permissions your app needs. Click <strong>Install</strong> to complete the installation.</p></figcaption></figure>

#### 13. Go to Settings

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial14.png" alt="Go to Settings"><figcaption><p>Navigate to the \"Settings\" tab in the left sidebar to access your app credentials.</p></figcaption></figure>

#### 14. Copy Your Credentials

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial15.png" alt="Copy Your Credentials"><figcaption><p>In the Settings page, you'll find your \"Credentials\" section containing your <strong>Client ID</strong> and <strong>Secret</strong>. Click the copy icon next to each field to copy these values.</p></figcaption></figure>

#### 15. Enter Your Credentials

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial16.png" alt="Enter Your Credentials"><figcaption><p>Return to the Hypercape BIZ connection modal. Paste your copied <strong>Client ID</strong> and <strong>Client Secret</strong> into the corresponding fields. Enter your Shopify store URL (the part before .myshopify.com). Click \"Connect my store\" to complete the connection.</p></figcaption></figure>

#### 16. Connection Complete!

<figure><img src="https://biz.hypercape.com/static/images/faq/tutorial17.png" alt="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 %}