> ## Documentation Index
> Fetch the complete documentation index at: https://docs.drpn.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Shopify

> Create the Shopify connection used by API-backed reconciliation runs and automations.

Shopify setup is a one-time task — save the connection once and every reconciliation run or automation that reads Shopify order data can use it from then on.

<Note>
  Keep access tokens, customer hostnames, and account-specific values in secure configuration. The docs should describe the sequence, not store credentials.
</Note>

## Before you start

Confirm:

* You are signed in to the correct active company or active tenant.
* Your user can edit connection settings.
* The Shopify shop or Admin API URL is known.
* The Shopify API version is known.
* The timezone for Shopify date windows is known.
* The Shopify access token can read orders.

## Steps

<Steps>
  <Step title="Open Shopify settings">
    Open **Ask Darpan** with `Cmd/Ctrl+K` or the floating **Ask Darpan** button. Search for **Open Shopify Settings** and open the result.
  </Step>

  <Step title="Create the Shopify connection">
    Choose **Create Shopify Config**. Answer the setup questions:

    1. **Shop/API URL**
    2. **API Version**
    3. Timezone
    4. **Access Token**
    5. Shopify label

    Save the connection. Darpan creates it as active and derives the connection ID from the label. If the ID, active state, or endpoint access needs to change later, open the saved connection from **Open Shopify Settings** and edit it.
  </Step>

  <Step title="Confirm the connection is reusable">
    Return to **Open Shopify Settings**. The saved connection should appear on the settings surface.

    The connection is ready when a reconciliation run or automation can select Shopify as an API source.
  </Step>
</Steps>

## Validation

Use a small read-only reconciliation run or automation test with a narrow date range. Confirm Shopify returns orders before using the setup for scheduled reconciliation.

## Troubleshooting

* If Shopify fails, check the shop URL, API version, token validity, timezone, and order-read permission.
* If Shopify does not appear as an API source, confirm the connection is active and that **Admin GraphQL Orders** is enabled on the saved record.
* If records return outside the expected window, confirm the timezone used for Shopify date windows.