# Shopify

## Shopify Connector Setup

To connect your Shopify store to dex, you'll need to generate API credentials and configure read-only access in your Shopify Admin.

{% embed url="<https://www.youtube.com/watch?v=5NAPoS2lkPg>" %}

### 1. Create a Custom App in Shopify

1. Go to your **Shopify Admin Panel**.
2. In the left menu, click **Settings** → **Apps and sales channels**.
3. Click **Develop apps** (enable this option if prompted).
4. Click **Create an app**.
5. Enter a name (e.g., `dex_shopify_connector)` and select an app developer.

### 2. Configure API Access Scopes

1. Go to the **Configuration** tab of your app.
2. Click **Configure Admin API scopes**.
3. Select **read-only** permissions for the relevant resources:

```
read_orders
read_products
read_customers
read_inventory
read_discounts
read_analytics
read_fulfillments
read_shipping
read_locales
read_marketing_events
read_checkouts
read_reports
read_price_rules
read_translations
```

4. Click **Save**.

### 3. Install the App and Generate Credentials

1. Open the **API Credentials** tab.
2. Click **Install App** to install it on your store.
3. Once installed, click **Reveal token once** to view your **Admin API access token**.
4. Copy the following details for use in dex:

* Admin API Access Token
* API Key
* Store name
* API version (e.g., `2024-10`)

### 4. Configure the Connector in dex

In the **Advanced Settings** screen inside dex:

| Field           | Description                                         |
| --------------- | --------------------------------------------------- |
| **API Key**     | Your Admin API Access Token                         |
| **Store**       | Your store name (e.g., `my-store`)                  |
| **API Version** | The API version you noted earlier (e.g., `2024-10`) |
| **Path Params** | Leave empty unless otherwise instructed             |

Click **Test and Save** to validate the connection.

Once connected, dex will begin syncing data from your Shopify store, giving you access to orders, products, customers, and more — all in your own cloud environment.

{% hint style="info" %}
dex currently supports the Shopify **REST API**, which continues to function but is no longer actively updated by Shopify beyond version `2025-01`.\
Shopify has since introduced a new **GraphQL API**, which is supported via a separate connector.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dexlabs.io/lakehouse-platform/connect-your-data/connector-catalog/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
