Overview
Cin7 is an inventory management + order fulfillment platform popular with multi-channel retailers and wholesalers. The Automize Cin7 connector covers products, stock levels + adjustments, sales orders, purchase orders, and contacts.
- Regions: Cin7 Core (formerly DEAR) is global. Cin7 Omni for larger enterprise. Connector targets Cin7 Core's API.
- Plans: Cin7 Core paid plans expose the API. Higher tiers add more integration features.
Setting up the connection
Auth type: HTTP Basic.
- Sign in to Cin7 Core (inventory.dearsystems.com) → Integration & API → Add API Application.
- Copy Account ID + Application Key.
- In Automize, open Settings → Connectors → Cin7 → Add connection. Pass as api-auth-accountid header + api-auth-applicationkey header (connector handles the format).
Find your credentials at https://inventory.dearsystems.com/.
Rate limits
Cin7 enforces 60 calls/min per account. Connector retries 429 with backoff.
Data model
Inventory + commerce primitives:
Account ─┬─ Products ─── Stock Levels (per warehouse)
├─ Contacts (customers + suppliers)
├─ Sales Orders ─── Pick + Pack + Ship
├─ Purchase Orders ─── Receive Stock
└─ WarehousesAvailable operations
12 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Adjust Stock | General | Adjust stock quantity |
| Create Order | General | Create a new sales order |
| Create Product | General | Create a new product |
| Create Purchase Order | General | Create a purchase order |
| Get Order | General | Get sales order by ID |
| Get Product | General | Get product by ID |
| List Contacts | General | List all contacts |
| List Orders | General | List sales orders |
| List Products | General | List all products |
| List Purchase Orders | General | List purchase orders |
| List Stock | General | List stock levels |
| Update Product | General | Update an existing product |
Operations
Adjust Stock
Adjust stock quantity
| Parameter | Required | Type | Description |
|---|---|---|---|
Productid productId | Yes | text | |
Warehouseid warehouseId | Yes | text | |
Qty qty | Yes | text | |
Reason reason | Yes | text |
Tips
- productId + warehouseId + qty (positive or negative) + reason.
- Use for restocks, write-offs, transfers – anything not via a sale or purchase.
Create Order
Create a new sales order
| Parameter | Required | Type | Description |
|---|---|---|---|
Contactid contactId | Yes | text | |
Lineitems lineItems | Yes | text |
Tips
- contactId + lineItems[{productId, qty, price}].
- Status starts DRAFT – transition through pick/pack/ship via separate update calls.
Create Product
Create a new product
| Parameter | Required | Type | Description |
|---|---|---|---|
Productname productName | Yes | text | |
Category category | Yes | text | |
Unitprice unitPrice | Yes | text |
Tips
- productName + category + unitPrice required.
- sku optional – auto-generated if omitted.
Create Purchase Order
Create a purchase order
| Parameter | Required | Type | Description |
|---|---|---|---|
Supplierid supplierId | Yes | text | |
Lineitems lineItems | Yes | text |
Tips
- supplierId + lineItems[{productId, qty, price}].
- Auto-creates stock receipts when marked received.
Get Order
Get sales order by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Order Id order_id | Yes | text |
Tips
- Returns order + lines + payments + fulfilments.
Get Product
Get product by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Product Id product_id | Yes | text |
Tips
- product_id (UUID). Returns full product + variants + suppliers.
List Contacts
List all contacts
No input parameters.
Tips
- Customers + suppliers. Filter by Type, IsActive.
List Orders
List sales orders
No input parameters.
Tips
- Sales orders. Filter by Status (DRAFT, AUTHORISED, PICKED, PACKED, SHIPPED, INVOICED).
List Products
List all products
No input parameters.
Tips
- Page via Page + Limit (max 100). Filter by Category, SKU, Name.
List Purchase Orders
List purchase orders
No input parameters.
Tips
- Purchase orders to suppliers. Filter by Status.
List Stock
List stock levels
No input parameters.
Tips
- Returns current stock per (product, warehouse).
Update Product
Update an existing product
| Parameter | Required | Type | Description |
|---|---|---|---|
Id id | Yes | text | |
Productname productName | Yes | text | |
Category category | Yes | text |
Tips
- id (UUID) + fields to change. PUT-style.
FAQ
- Cin7 Core vs Cin7 Omni – which?
- Cin7 Core (ex-DEAR) is the SMB cloud product. Cin7 Omni is the enterprise warehouse/inventory ERP. This connector targets Cin7 Core.
- Why does Adjust Stock fail with 'product not stocked in warehouse'?
- Product must exist + be enabled in the target warehouse first. Configure in Cin7 UI before adjusting.
- Multi-channel sync – Shopify + Cin7?
- Cin7 has built-in Shopify integrations – usually preferred over manual API sync. Use the Cin7 connector for non-Shopify workflows or custom logic on top of the built-in sync.