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

# Shopify

Shopify is an e-commerce platform for managing online stores. Connecting Shopify to Duvo lets your agents manage products, process orders, handle customer data, and automate store operations directly from your workflows.

## Setup

Shopify offers two ways to connect: through Duvo's own Shopify app, or with your own custom app created in the Shopify Dev Dashboard.

### Connect with Duvo

<Note>
  This method is temporarily unavailable while Shopify reviews Duvo's app. Use **Use your own Shopify app** below to connect in the meantime.
</Note>

On the [Connections page](https://app.duvo.ai/integrations), click **Enable** next to Shopify. Enter your store domain in the format `your-store.myshopify.com`, then click **Enable** to be redirected to Shopify's authorization screen. Authorize Duvo to access your store — you will be returned to Duvo with the connection active.

### Use your own Shopify app

Create a custom-distribution app in your Shopify Dev Dashboard, then connect it to Duvo with its client ID and client secret.

<Steps>
  <Step title="Create a custom app" icon="store">
    Sign in to the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard) with a staff account that has the App development permission (store owners have it automatically). On the **Apps** page, click **Create app** at the bottom of the page and choose **Start from Dev Dashboard** — you do not need the Shopify CLI. Name the app and click **Create**.
  </Step>

  <Step title="Configure an app version" icon="key">
    Open the app's **Versions** tab and create a version. Set **App URL** to `https://shopify.dev/apps/default-app-home` (the app has no interface of its own) and leave **Embed app in Shopify admin** off.

    Paste **all** of the following Admin API access scopes into the **Scopes** field. Duvo verifies them when you connect, and the connection fails if any are missing:

    ```text theme={"dark"}
    read_products,write_products,read_orders,write_orders,read_customers,write_customers,read_inventory,write_inventory,read_fulfillments,write_fulfillments,read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_draft_orders,write_draft_orders,read_discounts,write_discounts,read_returns,write_returns,read_locations,read_files,write_files
    ```
  </Step>

  <Step title="Add the redirection URL" icon="link">
    In the same version, add Duvo's redirection URL to the **Redirect URLs** field, then release the version:

    ```text theme={"dark"}
    https://platform.duvo.ai/v1/oauth/callback/shopify
    ```

    The same URL is shown on the Duvo connect form with a copy button.
  </Step>

  <Step title="Find your credentials" icon="settings">
    Open the app's **Settings** to find its **Client ID** and **Client secret**. Apps created from your store's account use custom distribution automatically — if your organization also has a Shopify partner account, select **Custom distribution** in the **Distribution** section of the app's Home page instead.
  </Step>

  <Step title="Connect in Duvo" icon="circle-check">
    On the [Connections page](https://app.duvo.ai/integrations), open Shopify, choose **Use your own Shopify app**, enter your store domain and the app credentials, then click **Continue to Shopify** to authorize. Shopify may warn that the app isn't verified — this is expected for a custom app you created yourself.
  </Step>
</Steps>

## Capabilities

* **Product and variant management** — List, create, update, and delete products and their variants. Upload product images directly from a URL.
* **Collection management** — Create collections, list and retrieve collection details, and add or remove products from collections.
* **Order management** — List and retrieve orders, cancel, close, or reopen orders, and create refunds with optional suggested-refund calculation.
* **Draft orders** — Create, update, complete, and send invoices for draft orders.
* **Customer management** — List, create, update, and search customers by name, email, or phone. Customer and draft-order tools require [Protected Customer Data access](https://shopify.dev/docs/apps/launch/protected-customer-data) to be approved for your app. Custom apps created in the Shopify Dev Dashboard have Level 1 and Level 2 access available by default, with no Shopify app review required.
* **Inventory** — Retrieve inventory levels across locations, adjust quantities, and set inventory to a specific value.
* **Fulfillment** — List fulfillment orders, create and cancel fulfillments, and update tracking information.
* **Discounts** — View active discount codes and create new code-based discounts in a single step, with no separate price rule required.
* **Metafields** — Read and write metafields on any Shopify resource.
* **Store and locations** — Retrieve shop details and list all fulfillment locations.
* **Bulk export** — Run a bulk GraphQL export to download large data sets as a JSONL file written directly to the assignment's workspace.

## Key Benefits

* **Hands-off store management** — Automate repetitive Shopify tasks so your team can focus on merchandising strategy and growth.
* **Real-time data access** — Work with live store data instead of manual exports or scheduled reports.
* **Cross-system workflows** — Combine Shopify data with other connections to drive end-to-end business processes.
* **Consistent operations** — Ensure store updates follow the same process every time, reducing errors and missed steps.

## Works Well With

<CardGroup cols={3}>
  <Card title="Google Sheets" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/google-sheets.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=0ef8d55e05c34e7a4a618933bdf0ceb3" href="/user-guide/connections/available-connections/google-sheets" width="24" height="24" data-path="images/connections/google-sheets.svg">
    Pull order and product data into spreadsheets for analysis, reporting, or inventory planning.
  </Card>

  <Card title="Microsoft Excel" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/excel.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=986599d60d09acee47293fda2b62df99" href="/user-guide/connections/available-connections/microsoft-excel" width="2290" height="2130" data-path="images/connections/excel.svg">
    Pull order and product data into spreadsheets for analysis, reporting, or inventory planning.
  </Card>

  <Card title="Gmail" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/gmail.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=ad4e229283f3fe2f26c0f96a49f28e13" href="/user-guide/connections/available-connections/gmail" width="88" height="66" data-path="images/connections/gmail.svg">
    Send order summaries, customer follow-ups, or inventory alerts based on Shopify data.
  </Card>

  <Card title="Microsoft Outlook" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/outlook.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=e29aeb65c8cffce1cd3c83b81289b71f" href="/user-guide/connections/available-connections/microsoft-outlook" width="1831" height="1703" data-path="images/connections/outlook.svg">
    Send order summaries, customer follow-ups, or inventory alerts based on Shopify data.
  </Card>

  <Card title="Slack" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/slack.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=8a64bdd1af39e903923e4a273b4a4618" href="/user-guide/connections/available-connections/slack" width="512" height="512" data-path="images/connections/slack.svg">
    Post order notifications, low-stock alerts, or daily sales summaries to team channels.
  </Card>

  <Card title="Microsoft Teams" icon="https://mintcdn.com/duvo-d8027998/O3tlM6eCuFk2uJpN/images/connections/teams.svg?fit=max&auto=format&n=O3tlM6eCuFk2uJpN&q=85&s=6402a90678b560d0b0a4fc3b02c0d3e0" href="/user-guide/connections/available-connections/microsoft-teams" width="2229" height="2073" data-path="images/connections/teams.svg">
    Post order notifications, low-stock alerts, or daily sales summaries to team channels.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.