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

# Shopify Admin

> Set up the Shopify Admin integration in Langdock using your own Shopify app.

Connect Shopify stores to Langdock with your own Shopify app. Create the app in the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). Paste the Client ID and Client Secret into Langdock. Shopify Admin uses [Bring Your Own OAuth Client](/en/admin/manage-integrations/bring-your-own-oauth). Keep the Client Secret in workspace admin settings, not in chat.

<Warning>
  This connection uses [application-level permissions](/en/using-langdock/integrations/connections#custom-scopes-and-application-level-permissions). Requests use the app's Admin API scopes, not the Shopify role of the person who installed the app.
</Warning>

You need:

* Access to the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). You need the **App development → Develop** permission if you do not own the store.
* Permission to install apps on the store you want to connect
* Workspace admin access in Langdock

## Setup

<Steps>
  <Step title="Create app">
    Open the [Shopify Dev Dashboard](https://dev.shopify.com/dashboard). Click **Create app**.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/g4jYSvCYkIalijTm/images/shopify_admin_setup1.png?fit=max&auto=format&n=g4jYSvCYkIalijTm&q=85&s=06824369cbddb4e23217e237e01c6072" alt="Shopify Dev Dashboard Apps page with the Create app button" style={{borderRadius: '6px'}} width="1840" height="1178" data-path="images/shopify_admin_setup1.png" />
    </Frame>
  </Step>

  <Step title="Name it">
    Enter **Langdock** or another name people will recognize. Use **Start from Dev Dashboard**, not Shopify CLI. Click **Create**.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/g4jYSvCYkIalijTm/images/shopify_admin_setup2.png?fit=max&auto=format&n=g4jYSvCYkIalijTm&q=85&s=d0cbdedac086b832802a0f1610fdbf79" alt="Create an app screen with Langdock entered as the app name under Start from Dev Dashboard" style={{borderRadius: '6px'}} width="1840" height="1204" data-path="images/shopify_admin_setup2.png" />
    </Frame>
  </Step>

  <Step title="Add scopes & redirect URL">
    Open the app version. Open **API access**. Under **Scopes**, paste this comma-separated list.

    ```
    read_discounts,read_inventory,read_locations,read_orders,read_products,write_discounts,write_files,write_inventory,write_merchant_managed_fulfillment_orders,write_products
    ```

    In Langdock, go to **Admin → Integrations → Shopify Admin**. Create the custom OAuth client. Copy **Redirect URL** from Langdock. Paste it under **Redirect URLs** in Shopify. The domain depends on your deployment.

    ```
    https://app.langdock.com/api/integrations/{integration-id}/callback
    ```

    Save the scopes and redirect URL. Release the app version.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/g4jYSvCYkIalijTm/images/shopify_admin_setup3.png?fit=max&auto=format&n=g4jYSvCYkIalijTm&q=85&s=c22a8a1f2a70531e6ae83c8c328acd04" alt="API access settings with Scopes and Redirect URLs fields" style={{borderRadius: '6px'}} width="1840" height="1214" data-path="images/shopify_admin_setup3.png" />
    </Frame>
  </Step>

  <Step title="Copy client & secret into Langdock & authenticate">
    In the Dev Dashboard, open **Settings**. Copy **Client ID** and **Client secret**.

    In Langdock, paste them into the custom OAuth client for Shopify Admin. Save.

    Connect a store. Enter a custom domain like `shop.acme.com`, a `*.myshopify.com` domain, or the store handle. Complete Shopify's install screen. The app then has the Admin API scopes from step 3.

    <Frame>
      <img src="https://mintcdn.com/langdock-34/g4jYSvCYkIalijTm/images/shopify_admin_setup4.png?fit=max&auto=format&n=g4jYSvCYkIalijTm&q=85&s=80161d94cf9acc3e0db2ee2f245d42b5" alt="App Settings page showing Client ID and Client secret" style={{borderRadius: '6px'}} width="1840" height="1142" data-path="images/shopify_admin_setup4.png" />
    </Frame>
  </Step>
</Steps>

<Info>
  Each Langdock connection is one shop. Connect every store separately. You can reuse the same custom OAuth client. You still need permission to install apps on each shop.
</Info>

## What you can do after setup

You can look up and update products, inventory, locations, orders, fulfillments, discounts, and files in the connected store.

## Troubleshooting

**Invalid redirect URI**
The Redirect URL in Shopify must match Langdock's **Redirect URL** exactly. Include `https` and `/callback`.

**OAuth client is not configured**
Save Client ID and Client Secret under **Admin → Integrations → Shopify Admin** before you connect a store.

**Access denied / forbidden**
The app version must include the scopes above. Complete the Shopify install screen with an account that can install apps.

**Invalid store domain**
Enter the domain you use for the store, the `*.myshopify.com` domain, or the store handle. Strip `https://`.