All articles
On this page
Daily Use
Connecting Shopify to HQ
Shopify store owners and their teams who want Claude Code, Codex, and their bots to read the store's products, orders, and inventory.
Once your Shopify store is connected, you can ask HQ about it in plain words. For example: "How many orders came in yesterday?", "Which products are low on stock?", or "List our best sellers this month." Everyone in your company who's allowed to use the app can ask, and nobody has to log in to Shopify or copy reports by hand.
Shopify takes a few more steps than most apps. Shopify no longer hands out a key from the store admin, so you first create a small private app in Shopify, then give HQ its details.
Already use a data platform like Triple Whale or Polar Analytics? If your Shopify data already flows into one, connect that platform to HQ instead. It's usually much quicker than connecting Shopify, and you get your store data alongside your ad and marketing numbers. To check if yours is available, ask HQ: "Can I connect Triple Whale to HQ?" More in Connecting Your Apps to HQ.
What you need#
- Owner or staff access to the Shopify store with permission to develop apps.
- HQ, signed in, with Claude Code or Codex. See Using HQ with Claude Code.
- A member of your HQ company (not a guest). Once it's connected, share it with your team. See Connecting Your Apps to HQ.
Step 1: Create an app in Shopify#
- In your Shopify admin, go to Settings → Apps.
- Click Develop apps, then Build apps in Dev Dashboard.
- In the Dev Dashboard, click Create app.
- Under Start from Dev Dashboard, name the app (for example "HQ") and click Create.
Step 2: Choose what HQ can see, then install the app#
- In the app's new version, find the Access section and enter the scopes (permissions). To let HQ read your store without changing anything, use:
read_productsread_ordersread_inventory
- Leave the app URL as it is.
- Click Release, then Release again to confirm.
- Click Install app, pick your store, and click Install.
- Open the app's Settings and copy the Client ID and Client secret. You'll use them in the next step.
Start with read-only. Only add scopes like write_products if you want HQ to make changes in your store. You can add more later by releasing a new version, and you'll need to approve the new scopes in your Shopify admin.
Keep the client secret private. Don't paste it into a chat. The next step saves it safely.
Step 3: Connect it in HQ#
In Claude Code or Codex, say:
- "Connect our Shopify store to HQ for Acme. The store is acme.myshopify.com."
HQ walks you through the rest. When it needs the client ID and client secret, have it save them as secrets in your company's vault (for example with a one-time link) instead of pasting them into the chat. See the Secrets Guide.
Shopify's access keys only last 24 hours, and HQ can't renew them on its own yet. Email support@hqforwork.com and we'll help you set it up so it keeps working.
Step 4: Try it#
Ask HQ about your store:
- "How many orders did we get yesterday?"
- "Which products have fewer than 10 in stock?"
- "Show me the last five orders over $200."
Good to know#
- It only works for your own store. Shopify only lets this kind of app reach stores in the same Shopify organization as the app. To connect a client's store, the client should create the app in their own Shopify account.
- HQ only sees what the scopes allow. If HQ says it can't see something, add that scope in Shopify, release a new version, and approve it.
- Changes need approval. If you gave HQ write scopes, HQ can ask an owner to approve anything that changes your store before it happens. See Connecting Your Apps to HQ.
- Building a custom storefront? That's a different setup. Ask the HQ team.
Common questions#
I don't see "Develop apps" in my Shopify settings.
Your Shopify account may not have permission to develop apps. Ask the store owner to give you that permission, or have them do these steps.
I created a custom app in my Shopify admin before 2026. Can I use that?
Yes. Apps created in the Shopify admin before January 1, 2026 still work, and you can get their Admin API access token from your Shopify admin. Shopify only shows that token once. Email support@hqforwork.com and we'll help you connect it to HQ.
HQ says it can't reach my store.
Check that the app is installed on the store, and that the store is in the same Shopify organization as the app. Shopify shows the error "Client credentials cannot be performed on this shop" when it isn't.
If you get stuck#
See The "I'm Stuck" Guide, or report it with /hq-bug. It packages the details for the team automatically.