Shopify
Read and update a Shopify store's products, orders, customers and inventory through the Admin API.
Connect it with: API key. Shopify's own documentation: https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/generate-app-access-tokens-admin.
What agents can do
Connect Shopify so the agents working your tasks can reach it. With it connected, they can:
- Look up an order, its fulfilment and refund state when a support task names an order number.
- Find products that are out of stock, unpublished or missing images and descriptions.
- Update product prices, inventory levels or tags when a task asks (needs the matching write scopes).
- Export orders for a date range to build a sales or tax report.
Before you start
- A Shopify store and a staff account with the Apps permission (the store owner has it).
- An app on the store whose Admin API access token you can copy: a custom app created in the Shopify admin before 1 January 2026, or a token your developer issued for this store.
- The app's Admin API scopes set to what agents need, such as read_products, read_orders and write_inventory.
- A Jaah account. Anyone can add a personal secret; an organization secret needs an Org Owner or Admin.
Connect with Shopify
Jaah connects to Shopify with an API key, not with a sign-in button.
Connect with an API key
Find each value first:
- Store name: The first part of your store's admin address: for acme-store.myshopify.com it is acme-store. Find it in Shopify admin > Settings > Domains, on the line ending in .myshopify.com.
- Admin API access token: In Shopify admin, open Settings > Apps > Develop apps (Legacy custom apps on stores that have them), select the app, open API credentials and reveal the Admin API access token, which starts with shpat_. Shopify shows it once: if it is lost, uninstall and reinstall the app to get a new one.
Then add it to Jaah:
- In Jaah, open Secrets, select New, and pick the Shopify card.
- Name the secret and choose who can use it.
- Fill in Store name, Admin API access token.
- Select Save. Jaah tests the secret straight away (see Test the connection).
Jaah encrypts what you type and never shows it again — not to you, and not to an admin.
Use your own OAuth app
Not used: Jaah connects to Shopify with an API key, not through an OAuth app.
Test the connection
Select Test on the secret. Jaah calls Shopify's API once (GET https://<Store name>.myshopify.com/admin/api/2026-10/shop.json) with the stored values, and shows who it answered as, or which value Shopify refused and the status it answered. Jaah also tests automatically when you save or reconnect.
The last result and its time stay on the secret's page, so you can see whether it still works without testing again.
Who can use it
Every secret has an owner, and the owner decides who can use it:
- Personal — only your own tasks can use it. This is the default.
- Organization — every task in the organization can use it. Only Org Owners and Admins can choose this.
- Attached to a project — every task on that project can use it, whoever started the task. See Attach a secret to a project.
More on owners and access: How secrets work.
Use it in an agent session
An agent asks for the secret with its credential_get tool, by the secret's path, when it needs it, and gets the values for that one call. The path is the owner's prefix and the secret's name:
org/<name>for an organization secret,projects/<project>/<name>for one attached to a project,me/<name>for your personal one.
A key connection hands the agent its fields: shop, access_token.
Tell the agent in your task description which secret to use, for example “use the Shopify secret org/shopify”.
Manage, rotate or disconnect
Everything is on the secret's page under Secrets:
- Rotate a key: create a new key at the vendor first, then select Replace on the secret and paste it. Revoke the old key at Shopify once the test passes. Steps: Replace or delete a secret.
- Disconnect: select Delete. The stored values are destroyed and agents lose access on their next call. To end access at Shopify's side too, revoke or delete the key at Shopify.
Limitations
- Shopify stopped letting stores create new custom apps in the admin on 1 January 2026. Apps made in the Shopify Dev Dashboard issue tokens that expire after 24 hours, which this connection cannot renew yet: use a token from an existing custom app.
- The token can do only what its app's Admin API scopes allow; changing scopes means reinstalling the app and copying the new token.
- Shopify throttles the Admin API per store (a leaky bucket for REST, a cost budget for GraphQL); bulk work is slowed down, not refused.
- Agents can do only what the connected Shopify account allows.
Troubleshooting
Test says Shopify rejected the admin API access token (401)
The token was revoked (the app was uninstalled or its token rotated) or belongs to another store. Reveal the token again in Settings > Apps > Develop apps and select Replace.
Test says Shopify cannot be reached at that address
Store name must be only the myshopify.com name, such as acme-store, not your own domain and not the full address.
An agent's call is refused with 403
The app lacks the scope for that call. Add it under the app's Configuration > Admin API scopes, reinstall the app and replace the token.
Still stuck? Select Test and read the result: it names the value Shopify refused and the status it answered.
FAQ
Can I use my store's own domain?
No. The Admin API answers only on the store's myshopify.com address, so enter that name.
Does Test change anything in my store?
No. It reads the store's name and nothing else.
Can Jaah or an admin see the key or token?
No. Jaah stores it encrypted and never shows it again. Only the tasks allowed to use the secret receive it, at the moment they ask for it.
Can I connect more than one Shopify account?
Yes. Add one secret per account, each with its own name, and tell the agent which one to use.