Magento / Adobe Commerce
Org-level connection
Magento / Adobe Commerce is connected once at the org level by an admin. The credential is shared across all groups that have been granted access — individual team members don't need to connect their own accounts.
Getting your API key
Enter your Magento Store URL in the field above — use the exact domain you log in to Magento admin with (e.g. https://store.com).
Enable the standalone Bearer-token flag: in Magento admin go to Stores → Configuration → Services → OAuth, set "Allow OAuth Access Tokens to be used as standalone Bearer tokens" to Yes, and click Save Config. (Magento 2.4.4+ rejects every API call with a 401 until this is on — it is the #1 install failure.)
Flush the Magento cache: go to System → Cache Management and click "Flush Magento Cache". The Bearer-token flag does not take effect until you do this.
In Magento admin go to System → Extensions → Integrations → Add New Integration, and name it "On Belay".
On the Integration's API tab, set "Resource Access" to Custom — this reveals the resource tree (it stays hidden while Resource Access is set to All).
In the revealed resource tree, check the top-level Sales, Catalog, and Customers boxes (each one grants its whole subtree), then expand Stores and check Settings.
Click Save to save the Integration.
On the Integrations list, click Activate on the "On Belay" row — a popup opens listing the permissions you granted.
In that popup, click Allow — the next screen shows your four integration values.
Magento shows four values — Consumer Key, Consumer Secret, Access Token, and Access Token Verifier. Copy only the Access Token. Do not copy the Access Token Verifier below it.
Paste the Access Token into the field below and click Connect.
You may see an "Integration not secure" badge in Magento — that is cosmetic and expected; On Belay does not need the callback or identity URLs.
Ready to connect?
Sign in to On Belay and open the Integrations page to add Magento / Adobe Commerce.
Permissions (scopes)
These are the data scopes On Belay can be granted for Magento / Adobe Commerce. Your org admin controls which scopes are enabled per group.
| Scope | Description | Access |
|---|---|---|
orders:read | Read orders | Read only |
orders:write | Create, hold, cancel, invoice, ship, and refund orders | Read / Write |
products:read | Read products and attributes | Read only |
products:write | Create, update, and delete products and media | Read / Write |
categories:read | Read categories | Read only |
categories:write | Create, update, delete, and assign categories | Read / Write |
inventory:read | Read inventory sources, stocks, and source items (MSI) | Read only |
inventory:write | Manage inventory sources, stocks, and source items (MSI) | Read / Write |
customers:read | Read customers | Read only |
customers:write | Create, update, and delete customers | Read / Write |
invoices:read | Read invoices | Read only |
invoices:write | Capture, void, and email invoices | Read / Write |
shipments:read | Read shipments | Read only |
shipments:write | Add and remove shipment tracking | Read / Write |
creditmemos:read | Read credit memos | Read only |
creditmemos:write | Create credit memos and comments | Read / Write |
carts:read | Read admin carts / quotes | Read only |
carts:write | Manage admin carts and convert to orders | Read / Write |
store:read | Read store websites, views, config, currencies, and tax rates | Read only |
Troubleshooting
"Invalid API key" or "Unauthorized" error
Connected but Claude can't access data
The key expires or stops working
Still stuck? We're happy to help.
Contact support →