Cin7 Omni
Connect Cin7 Omni to manage stock levels, purchase orders, warehouses, products, and fulfillment workflows.
You end up with your Cin7 Omni API Username and the API Key of one API v1 connection, which PopMCP sends together as HTTP Basic auth.
- Setup time
- 6 min
- Auth
- API credentials
- API base URL
- https://api.cin7.com/api/v1
- Rate limits
- Three calls a second, 60 a minute and 5,000 a day. Anything beyond returns HTTP 429.
Before you begin
- A Cin7 Omni account. This is the legacy Omni product, not Cin7 Core (formerly DEAR), which uses different credentials
- An administrator user. The Integrations & API settings are admin-only
- A free API connection slot. Cin7 caps how many connections a site may have and only support can raise it
Get your credentials
Sign in to Cin7 Omni as an administrator
Sign in at go.cin7.com with an administrator account.
Open Settings, then Integrations & API, then API v1
Open Settings from the user menu in the top navigation, then under Integrations & API select API v1. Copy the API Username printed at the top of the page.
API v1
Basic-auth connections into this Cin7 Omni account.
- API Username
- AcmeTradingCoAPI
- Connections used
- 2 of 5
| App Name | API Key | Status | Created |
|---|---|---|---|
| Warehouse sync3PL bridge | 3a91c204-****-****-****-********77e2 | Active | Mar 4, 2026 |
| Old storefrontretired | b7e05f19-****-****-****-********31c4 | Disabled | Jun 9, 2025 |
The API Username is shared by every connection on the account. Each connection has its own key.
Add a new API connection and copy the key
Click Add New API Connection, enter an App Name such as PopMCP, and save. Copy the API Key from the confirmation before you close it.
Add New API Connection
The key is shown once. Lose it and you must use Regenerate Key, which invalidates the old value.
Tick the permissions the connection needs
Open Permissions under the API Connections list, tick read and write for every module the AI should touch, then click Save.
Permissions
PopMCP
Paste both values into PopMCP
Enter the API Username from step 2 and the API Key from step 3 into PopMCP.
API v1
- API Username
- AcmeTradingCoAPI
- API Key
- 8f2c1a90-****-****-****-********20ab
- Auth
- Authorization: Basic against https://api.cin7.com/api/v1
Connect in PopMCP
Open your workspace, choose Cin7 Omni in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API Usernametext | Cin7 Omni → Settings → Integrations & API → API v1 → Add New API Connection. Copy the API Username shown for the new connection. |
| API Keysecret | The API Key shown for that same connection. Stored encrypted; Cin7 shows it once.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Cin7 Omni immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows the Cin7 Omni connection as Connected and a product or stock listing tool returns items from your Cin7 catalogue.
Troubleshooting
401 Unauthorized
Why: The API Username and API Key are mismatched, or the key was regenerated after you copied it.
Fix: Recheck the username on the API v1 page and regenerate the connection key, then reconnect with the fresh pair.
403 mentioning a resource such as Branches
Why: That module is unticked in the connection's Permissions.
Fix: Open Permissions under API Connections, tick the module, click Save, and retry.
"Unable to create more than X API connections"
Why: The account has used all of its allotted connection slots.
Fix: Delete an unused connection, or ask Cin7 Omni support to add the new one for you.
Credentials rejected and your account looks nothing like the screens above
Why: You are on Cin7 Core, formerly DEAR, which uses an Account ID and Application Key instead.
Fix: Use the Cin7 Core connector, not this one.
429 Too Many Requests
Why: You exceeded 3 calls a second, 60 a minute or 5,000 a day.
Fix: Slow the tool calls down and prefer filtered queries on modified date instead of full listings.