Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | ## How do I set up custom OAuth credentials for Shopify? |
| 2 | |
| 3 | Use your own app from the Shopify Dev Dashboard when you want to choose the scopes and the app name merchants see, or when the default app isn't available. |
| 4 | |
| 5 | ### Create the Shopify app |
| 6 | |
| 7 | 1. Sign in to your Shopify admin. If you don't have a store, start one at [shopify.com](https://www.shopify.com/). |
| 8 | 2. Search for **App Development** in the admin search bar and open it, then click **Build apps in Dev Dashboard**. |
| 9 | |
| 10 | 3. Click **Create App**, enter an app name, and click **Create**. Shopify opens the app's version configuration. |
| 11 | |
| 12 |  |
| 13 | |
| 14 | 4. Set **App URL** to your application's URL. |
| 15 | |
| 16 |  |
| 17 | |
| 18 | 5. Select the access scopes your tools need, such as `read_products`, `write_products`, `read_orders`, `write_orders`, `read_customers`, and `read_inventory`. |
| 19 | |
| 20 |  |
| 21 | |
| 22 | 6. Set the redirect URL to `https://backend.composio.dev/api/v1/auth-apps/add`. It must exactly match the auth config's `oauth_redirect_uri` field. |
| 23 | |
| 24 |  |
| 25 | |
| 26 | 7. Click **Release**, optionally add a version name and message, and click **Release** again. |
| 27 | |
| 28 |  |
| 29 | |
| 30 | 8. Open **Settings** in the left sidebar and copy the **Client ID** and **Client Secret**. |
| 31 | |
| 32 |  |
| 33 | |
| 34 | ### Create the auth config in Composio |
| 35 | |
| 36 | 1. In the [Composio dashboard](https://dashboard.composio.dev/~/project/auth-configs?utm_source=docs&utm_medium=content&utm_campaign=toolkits-shopify), go to **Auth Configs** → **Create** and select **Shopify**. |
| 37 | 2. Choose **OAuth2** and your own credentials, then paste the Client ID and Client Secret. Keep the redirect URI as the value you registered in Shopify. Click **Create Auth Config**. |
| 38 | |
| 39 |  |
| 40 | |
| 41 | 3. Click **Connect Account** and enter the store subdomain: the permanent `myshopify.com` name, not a custom domain. For `https://acme.myshopify.com`, enter `acme`. You can find it under **Settings** → **Domains** in the Shopify admin. |
| 42 | |
| 43 | 4. Install the app on the store and grant the permissions. Confirm the account shows **Active** on the auth config's **Connected Accounts** tab. |
| 44 | |
| 45 | See [custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow. |
| 46 | |
| 47 | ### Scopes |
| 48 | |
| 49 | The default auth config requests read and write access to products, orders, customers, inventory, fulfillments, content, themes, discounts, draft orders, metaobjects, webhooks, and more. Select the same scopes on the Shopify app, and remove the ones you don't need from both. |
| 50 | |
| 51 | ## Why am I seeing "App not found" when connecting Shopify? |
| 52 | |
| 53 | The default Shopify OAuth app may be under review or expired. Use your own OAuth app or API authentication method until the default is restored. |
| 54 | |
| 55 | ## Shopify order update 403s can be caused by missing `read_all_orders` scope |
| 56 | |
| 57 | Check the scopes on the Shopify connection. If order reads or updates require access beyond the default order scope set, reconnect with the needed order scopes such as `read_all_orders` before retrying. |