Shopify
Connect each brand's Shopify store to show orders, revenue and customer counts. Shopify connects per brand. Orders and customers refresh every 15 minutes and are only ever read.
What it lights up #
- Finance · Shopify orders, revenue and customers per brand
- Scorecard · Shopify revenue and orders (30 days)
Option A: a Dev Dashboard app (new stores) #
Shopify no longer lets you create custom apps inside the Shopify admin (since 1 January 2026), so new setups use the Dev Dashboard.
- Open the Shopify Dev Dashboard at dev.shopify.com with the account that owns the brand's store. Choose Apps → Create app → Start from Dev Dashboard and name it VX Terminal.
- On the app's Versions page, add the Admin API access scopes read_orders and read_customers, nothing else, then Release that version.
- Install the app on the brand's store. The store and the app must be in the same Shopify organization; owning the store is not enough.
- Open the app's Settings (Credentials), and copy the Client ID and Client secret.
In VX Terminal, fill in Store address, Client ID and Client secret, and leave Admin API access token blank.
Option B: an existing custom app made in the Shopify admin #
If the store already has a custom app created in the Shopify admin before 2026, you can keep using it. In the Shopify admin open Apps → Develop apps, open the app, then API credentials, and use its Admin API access token (it usually starts with shpat_). It needs read access to orders and customers.
In VX Terminal, fill in Store address and Admin API access token, and leave Client ID and Client secret blank.
Connect it in VX Terminal #
- Open Settings → Connections, find Shopify and press Connect on the brand's row.
- Store address is the store's
myshopify.comaddress, likeacme-store.myshopify.com, not a custom domain. You'll find it in the Shopify admin under Settings → Domains. - Add the credentials from Option A or B, press Test, then Save.
How Test works #
Test reads the store's name, plan and currency, and confirms the app can read orders and customers. Nothing is changed.
Common errors #
| Message | Fix |
|---|---|
| "Store address must be the store's myshopify.com address, like acme-store.myshopify.com (not a custom domain)" | Use the myshopify.com address from Settings → Domains. |
| "Enter the app's Client ID and Client secret, or an Admin API access token" | Fill in one of the two options. |
| "Client secret is required with a Client ID" / "Client ID is required with a Client secret" | Option A needs both values. |
| "Shopify refused the Client ID and secret …" | Copy both again from the app's Settings page. Check the app is installed on the store and belongs to the same Shopify organization. |
| "Shopify rejected the Admin API access token. Check you copied all of it and that the app wasn't uninstalled." | Copy the token again, or reinstall the custom app. |
| "The app can't read the store. Check it is installed and its access was approved." | Install the app, or approve the new scopes in the store. |
| "There's no Shopify store at …. Check the store address." | Fix the myshopify.com address. |
| "Shopify is rate-limiting this store. Wait a minute and test again." | Wait, then test again. |