Cin7 Core integration
Cin7 Core (formerly DEAR Inventory) is an inventory and order management system. With this API an agent can manage products, product families, prices, stock levels, locations and reference data; run sales from quote to order, pick, pack, ship, invoice, credit note and payment; run purchases from order to stock received, put away, invoice, credit note and payment; and record stock adjustments, stock takes, transfers and write-offs. Not exposed: webhooks (their payloads carry the addresses withheld here), attachments, the production (MRP), assembly and disassembly modules, CRM (leads, opportunities, tasks, workflows), banking and money operations, bank accounts, journals, manual journals, deals and discounts, customer templates, fixed asset types, the deprecated simple-purchase routes, and full updates of sales, purchases, shipments, customers and suppliers. Postal addresses, tax numbers, bank account numbers, tracking and file links are not returned. Authentication: the Account ID and an API Application Key from the API setup page of Cin7 Core, sent as the api-auth-accountid and api-auth-applicationkey headers. Limit: 60 calls per minute per API Application (HTTP 429 beyond). Paged lists return Total and take Page and Limit (default 100, maximum 1000).
Say what should happen.
The workflow builds itself.
What you can do with Cin7 Core
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Payment, 8 operations
create_purchase_paymentCreate purchase paymentPOSTRecord a payment, prepayment or refund on a purchase (TaskID: the invoice task from get_purchase_invoices, the credit note task for a refund); needs an authorised invoice or credit note. Records money in the books for real.create_sale_paymentCreate sale paymentPOSTRecord a prepayment, payment or refund on a sale task (TaskID). Payments need an authorised invoice, refunds an authorised credit note, prepayments an authorised quote. Records money in the books. Changes real data in the Cin7 Core account.delete_purchase_paymentDelete purchase paymentDELETEDelete a purchase payment by ID (from list_purchase_payments); DeleteAllocation (vendor default true) also deletes allocated payments. Changes real data in the Cin7 Core account.delete_sale_paymentDelete sale paymentDELETEDelete a sale payment by ID (from list_sale_payments). Changes real data in the Cin7 Core account.list_purchase_paymentsList purchase paymentsGETList the payments, prepayments and refunds of a purchase by PurchaseID, or by order, invoice or credit note number.list_sale_paymentsList sale paymentsGETList the prepayments, payments and refunds of a sale by SaleID (from list_sales).update_purchase_paymentUpdate purchase paymentPUTUpdate a purchase payment by ID (from list_purchase_payments). A prepayment cannot be modified. Changes real data in the Cin7 Core account.update_sale_paymentUpdate sale paymentPUTUpdate a sale payment by ID (from list_sale_payments). A prepayment cannot be modified. Changes real data in the Cin7 Core account.
Order, 6 operations
create_purchase_orderCreate purchase orderPOSTWrite the order lines of a purchase (TaskID = the purchase ID from create_purchase or list_purchases); Status DRAFT or AUTHORISED. Replaces existing lines and adds new ones. Changes real data in the Cin7 Core account.create_sale_orderCreate sale orderPOSTWrite the order lines of a sale (SaleID); Status DRAFT or AUTHORISED. The quote must be AUTHORISED. A quantity above stock creates a backorder on authorising. Changes real data in the Cin7 Core account.create_stock_transfer_orderCreate stock transfer orderPOSTCreate or update the order of a stock transfer (TaskID from list_stock_transfers); Status DRAFT or AUTHORISED. Changes real data in the Cin7 Core account.get_purchase_orderGet purchase orderGETGet the order stage of a purchase (lines, additional charges, totals, status) by TaskID (the purchase ID from list_purchases).get_sale_orderGet sale orderGETGet the order stage of a sale (lines, charges, totals, status) by SaleID (from list_sales).get_stock_transfer_orderGet stock transfer orderGETGet the order stage of a stock transfer by TaskID (from list_stock_transfers), for transfers that do not skip the order.
Invoice, 5 operations
create_purchase_invoiceCreate purchase invoicePOSTCreate or fill a supplier invoice on a purchase (by PurchaseID); the order must be AUTHORISED, and with Approach STOCK the stock must be received first. Changes real data in the Cin7 Core account.create_sale_invoiceCreate sale invoicePOSTCreate or fill an invoice on a sale (SaleID; TaskID 00000000-0000-0000-0000-000000000000 starts a new one); the order must be AUTHORISED. Changes real data in the Cin7 Core account.get_purchase_invoicesGet purchase invoicesGETGet the invoices of a purchase with their lines and charges by PurchaseID (from list_purchases).list_sale_invoicesList sale invoicesGETList the invoices of a sale with their lines, charges and payments by SaleID (from list_sales). Billing address lines are not returned.update_sale_invoiceUpdate sale invoicePUTUpdate the memo or status of a DRAFT invoice of a sale (SaleID and TaskID from list_sale_invoices); the order must be AUTHORISED. Changes real data in the Cin7 Core account.
Attributeset, 4 operations
create_attribute_setCreate attribute setPOSTCreate an attribute set: Name plus up to 10 attributes, each with a name, a type and, for List, comma-separated values. Attribute1Name and Attribute1Type are required. Changes real data in the Cin7 Core account.delete_attribute_setDelete attribute setDELETEDelete an attribute set by ID (from list_attribute_sets). Permanently removes it from the account.list_attribute_setsList attribute setsGETList attribute sets (named groups of up to 10 custom product or customer attributes), one page at a time; filter by ID or by name prefix.update_attribute_setUpdate attribute setPUTUpdate an attribute set by ID (from list_attribute_sets). Attribute1Name and Attribute1Type are required on update too. Changes real data in the Cin7 Core account.
Brand, 4 operations
create_brandCreate brandPOSTCreate a product brand with the given Name. Changes real data in the Cin7 Core account.delete_brandDelete brandDELETEDelete a product brand by ID (from list_brands). Permanently removes it from the account.list_brandsList brandsGETList product brands, one page at a time; filter by name prefix.update_brandUpdate brandPUTRename a product brand: pass its ID (from list_brands) and the new Name. Changes real data in the Cin7 Core account.
Carrier, 4 operations
create_carrierCreate carrierPOSTCreate a carrier (shipping method) with the given Description. Changes real data in the Cin7 Core account.delete_carrierDelete carrierDELETEDelete a carrier by ID (the CarrierID from list_carriers). Permanently removes it from the account.list_carriersList carriersGETList carriers (shipping methods), one page at a time; filter by CarrierID or by description prefix.update_carrierUpdate carrierPUTRename a carrier: pass its CarrierID (from list_carriers) and the new Description. Changes real data in the Cin7 Core account.
Category, 4 operations
create_product_categoryCreate product categoryPOSTCreate a product category with the given Name. Changes real data in the Cin7 Core account.delete_product_categoryDelete product categoryDELETEDelete a product category by ID (from list_product_categories). Permanently removes it from the account.list_product_categoriesList product categoriesGETList product categories, one page at a time; filter by name prefix.update_product_categoryUpdate product categoryPUTRename a product category: pass its ID (from list_product_categories) and the new Name. Changes real data in the Cin7 Core account.
Creditnote, 4 operations
create_purchase_credit_noteCreate purchase credit notePOSTCreate or fill a credit note on a purchase (by PurchaseID); the invoice must be AUTHORISED or PAID. Changes real data in the Cin7 Core account.create_sale_credit_noteCreate sale credit notePOSTCreate or fill a credit note on a sale (SaleID; TaskID 00000000-0000-0000-0000-000000000000 starts a new one); the invoice must be AUTHORISED or PAID. Changes real data in the Cin7 Core account.get_purchase_credit_notesGet purchase credit notesGETGet the credit notes of a purchase with their lines and unstock lines by PurchaseID (from list_purchases).get_sale_credit_notesGet sale credit notesGETGet the credit notes of one sale with lines, charges, refunds and restock lines by SaleID (from list_sales).
Location, 4 operations
create_locationCreate locationPOSTCreate a stock location (warehouse), optionally with an address and bins. Bins can be created and deleted but not modified. Changes real data in the Cin7 Core account.delete_locationDelete locationDELETEDelete a stock location by ID (from list_locations). Permanently removes it from the account.list_locationsList locationsGETList stock locations (warehouses) with their bins and address, one page at a time; filter by ID, name prefix or deprecated flag.update_locationUpdate locationPUTUpdate a stock location by ID (from list_locations). Bins cannot be modified, only created or deleted. Changes real data in the Cin7 Core account.
Paymentterm, 4 operations
create_payment_termCreate payment termPOSTCreate a payment term: Name, Duration in days and Method. Changes real data in the Cin7 Core account.delete_payment_termDelete payment termDELETEDelete a payment term by ID (from list_payment_terms). Permanently removes it from the account.list_payment_termsList payment termsGETList payment terms (name, duration, method, active, default), one page at a time; filter by ID, name prefix, method, active or default.update_payment_termUpdate payment termPUTUpdate a payment term by ID (from list_payment_terms). Changes real data in the Cin7 Core account.
Product supplier, 4 operations
create_product_suppliersCreate product suppliersPOSTAdd supplier settings to products: each entry links a SupplierID and a ProductID with cost, supplier code and reorder options. Changes real data in the Cin7 Core account.delete_product_supplierDelete product supplierDELETEDelete the supplier settings of a product, with their options and intervals (ProductID and SupplierID). Changes real data in the Cin7 Core account.list_product_suppliersList product suppliersGETList the suppliers of a product (cost, supplier code, drop ship, reorder options per location) by ProductID (from list_products).update_product_suppliersUpdate product suppliersPUTUpdate product supplier settings (entries identified by ProductSupplierID from list_product_suppliers). Changes real data in the Cin7 Core account.
Custom price, 3 operations
create_custom_pricesCreate custom pricesPOSTCreate customer-specific prices: each entry gives a CustomerID, a ProductSKU and the Price. Returns a list of errors, empty on success. Changes real data in the Cin7 Core account.delete_custom_priceDelete custom priceDELETEDelete the custom price of one product for one customer (ProductID from list_products, CustomerID from list_customers). Changes real data in the Cin7 Core account.update_custom_pricesUpdate custom pricesPUTUpdate customer-specific prices: each entry gives a CustomerID, a ProductSKU and the new Price. Returns a list of errors, empty on success. Changes real data in the Cin7 Core account.
Inventory write off, 3 operations
create_inventory_write_offCreate inventory write offPOSTCreate an inventory write-off. Status DRAFT keeps it editable; COMPLETED writes the stock off at once and needs EffectiveDate. Changes real data in the Cin7 Core account.get_inventory_write_offGet inventory write offGETGet one inventory write-off with its lines by TaskID (from list_inventory_write_offs).update_inventory_write_offUpdate inventory write offPUTUpdate a draft inventory write-off by TaskID (from list_inventory_write_offs); Status COMPLETED writes the stock off. Changes real data in the Cin7 Core account.
Pack, 3 operations
create_sale_packCreate sale packPOSTPack picked stock into boxes for a fulfilment (TaskID): creates the pack or adds lines to it. The pick must be done. Changes real data in the Cin7 Core account.get_sale_packGet sale packGETGet the pack stage of a fulfilment (boxes, lines, status) by TaskID (from list_sale_fulfilments).update_sale_packUpdate sale packPUTReplace the pack lines of a fulfilment (TaskID) while the pack is not authorised. Changes real data in the Cin7 Core account.
Product, 3 operations
create_productCreate productPOSTCreate a product. SKU must be unique; Category, Brand, UOM and DefaultLocation must name existing records. Changes real data in the Cin7 Core account.list_productsList productsGETList products with prices, costing and accounts, one page at a time (Limit up to 1000); filter by ID, name, SKU or modified date; Include* flags add BOM, suppliers, movements or reorder levels.update_productUpdate productPUTUpdate a product by ID (from list_products). Type cannot be changed. Changes real data in the Cin7 Core account.
Product family, 3 operations
create_product_familyCreate product familyPOSTCreate a product family and its variant products (Products, each with Option1 to Option3 values). SKU must be unique. Changes real data in the Cin7 Core account.list_product_familiesList product familiesGETList product families (a parent with up to 3 options, such as size and colour, and its variant products), one page at a time; filter by ID, name, SKU or modified date.update_product_familyUpdate product familyPUTUpdate a product family by ID (from list_product_families). Products sent are added or updated; products cannot be removed from a family. Changes real data in the Cin7 Core account.
Ship zone, 3 operations
create_ship_zoneCreate ship zonePOSTCreate a shipping zone with the countries, states or post codes it applies to and its shipping cost conditions. Changes real data in the Cin7 Core account.delete_ship_zoneDelete ship zoneDELETEDelete a shipping zone by ShipZoneID (the ZoneID from list_ship_zones). Permanently removes it from the account.list_ship_zonesList ship zonesGETList shipping zones (where they apply and their cost conditions), one page at a time (default 25); filter by ID or name text.
Stock, 3 operations
create_purchase_stock_receivedCreate purchase stock receivedPOSTReceive stock on a purchase: adds new stock received lines (a new task when TaskID is left out); the order must be AUTHORISED. Converts a simple purchase to advanced. Changes real data in the Cin7 Core account.get_purchase_stock_receivedGet purchase stock receivedGETGet the stock received tasks of a purchase by PurchaseID (from list_purchases). Applies to advanced purchases when Use Put Away is on in the account settings.update_purchase_stock_receivedUpdate purchase stock receivedPUTReplace the data of a stock received task of a purchase (by PurchaseID and TaskID); the order must be AUTHORISED. Changes real data in the Cin7 Core account.
Unit, 3 operations
create_unit_of_measureCreate unit of measurePOSTCreate a unit of measure with the given Name. Changes real data in the Cin7 Core account.delete_unit_of_measureDelete unit of measureDELETEDelete a unit of measure by ID (from list_units_of_measure). Permanently removes it from the account.list_units_of_measureList units of measureGETList units of measure, one page at a time; filter by name prefix.
Advanced purchase, 2 operations
create_purchaseCreate purchasePOSTCreate a purchase header for a supplier (Approach INVOICE or STOCK first, Location required); add lines with create_purchase_order. Changes real data in the Cin7 Core account.get_purchaseGet purchaseGETGet one purchase (simple, advanced or service) by ID (from list_purchases) with its order, stock received, put away, invoices, credit notes and payments. Postal addresses are not returned.
Customer, 2 operations
create_customerCreate customerPOSTCreate a customer. Name must be unique; Currency, PaymentTerm, AccountReceivable, RevenueAccount and TaxRule take names or codes from the matching list tools. Changes real data in the Cin7 Core account.list_customersList customersGETList customers with their terms, accounts, contacts and child customers, one page at a time; filter by ID, name prefix, contact, modified date. Postal addresses and tax numbers are not returned.
Fulfilment, 2 operations
create_sale_fulfilmentCreate sale fulfilmentPOSTStart a new fulfilment on a sale by SaleID; the order must be AUTHORISED. A simple sale becomes an advanced sale. Changes real data in the Cin7 Core account.list_sale_fulfilmentsList sale fulfilmentsGETList the fulfilments of a sale (pick, pack and ship stages and statuses) by SaleID (from list_sales). Postal addresses and tracking links are not returned.
Markupprice, 2 operations
get_product_markup_pricesGet product markup pricesGETGet the markup price lines of a product by ProductID (from list_products), one per price tier; MarkupType D means the tier has no markup.update_product_markup_pricesUpdate product markup pricesPUTSet markup price lines of a product: a line for a tier is created or updated, and a line sent with MarkupType D deletes that tier markup. Changes real data in the Cin7 Core account.
Pick, 2 operations
create_sale_pickCreate sale pickPOSTPick stock for a fulfilment (TaskID); AutoPickMode AUTOPICK picks everything and authorises the pick. The order must be AUTHORISED. Changes real data in the Cin7 Core account.get_sale_pickGet sale pickGETGet the pick stage of a fulfilment (lines, locations, batches, status) by TaskID (from list_sale_fulfilments).
Put away, 2 operations
create_purchase_put_awayCreate purchase put awayPOSTPut received stock away on a purchase: adds new put away lines (a new task when TaskID is left out); the order must be AUTHORISED. Changes real data in the Cin7 Core account.get_purchase_put_awayGet purchase put awayGETGet the put away tasks of a purchase (stock placed into locations and bins) by PurchaseID (from list_purchases).
Quote, 2 operations
create_sale_quoteCreate sale quotePOSTWrite the quote lines of a sale (SaleID from create_sale or list_sales); Status DRAFT or AUTHORISED. Fails when the sale skips the quote. Changes real data in the Cin7 Core account.get_sale_quoteGet sale quoteGETGet the quote stage of a sale (lines, charges, totals, status) by SaleID (from list_sales).
Sale, 2 operations
create_saleCreate salePOSTCreate a sale header for a customer (Customer or CustomerID; Location required). Add lines with create_sale_quote or create_sale_order. Changes real data in the Cin7 Core account.get_saleGet saleGETGet one sale by ID (from list_sales) with its quote, order, fulfilments, invoices, credit notes and inventory movements. Postal addresses and attachment links are not returned.
Ship, 2 operations
create_sale_shipmentCreate sale shipmentPOSTShip packed boxes of a fulfilment (TaskID): creates the shipment or adds lines (carrier, tracking number, IsShipped). The pack must be AUTHORISED. Changes real data in the Cin7 Core account.get_sale_shipmentGet sale shipmentGETGet the ship stage of a fulfilment (boxes, carrier, tracking numbers, status) by TaskID (from list_sale_fulfilments). The shipping address and tracking links are not returned.
Stock transfer, 2 operations
create_stock_transferCreate stock transferPOSTCreate a stock transfer between two locations; Status IN TRANSIT or COMPLETED moves stock. Use update_stock_transfer to modify. Changes real data in the Cin7 Core account.get_stock_transferGet stock transferGETGet one stock transfer with its lines by TaskID (from list_stock_transfers).
Stockadjustment, 2 operations
create_stock_adjustmentCreate stock adjustmentPOSTCreate a stock adjustment: each line sets the new quantity and unit cost of a product at a location; Status COMPLETED applies it. Use update_stock_adjustment to modify. Changes real data in the Cin7 Core account.get_stock_adjustmentGet stock adjustmentGETGet one stock adjustment with its lines by TaskID (from list_stock_adjustments).
Stocktake, 2 operations
create_stock_takeCreate stock takePOSTStart a stock take for a location (status IN PROGRESS); tags and categories narrow the products counted. Use update_stock_take to enter counts. Changes real data in the Cin7 Core account.get_stock_takeGet stock takeGETGet one stock take with its products (with and without stock on hand) by TaskID (from list_stock_takes). Product image links are not returned.
Supplier, 2 operations
create_supplierCreate supplierPOSTCreate a supplier; Currency, PaymentTerm, TaxRule and AccountPayable take names or codes from the matching list tools. Changes real data in the Cin7 Core account.list_suppliersList suppliersGETList suppliers with their terms, accounts and contacts, one page at a time; filter by ID, name prefix or modified date. Postal addresses and tax numbers are not returned.
Tax, 2 operations
create_tax_ruleCreate tax rulePOSTCreate a taxation rule with its components (name, percent, account); Account must be an active LIABILITY account code. Changes real data in the Cin7 Core account.list_tax_rulesList tax rulesGETList taxation rules (name, account, rate, components, sale or purchase use), one page at a time; filter by ID, name, active, sale or purchase use, or account.
Account, 1 operation
list_chart_of_accountsList chart of accountsGETList the chart of accounts (account codes, names, classes, types, status), one page at a time; filter by code, name prefix, type or status. Bank account numbers are not returned.
Credit, 1 operation
list_customer_creditsList customer creditsGETList customer credits (unused credit notes and overpayments that can pay future sales), one page at a time; filter by CustomerID, optionally including used ones.
Deposit, 1 operation
list_supplier_depositsList supplier depositsGETList supplier deposits (prepayments that can pay future purchases), one page at a time; filter by SupplierID, optionally including used ones.
Inventory write off list, 1 operation
list_inventory_write_offsList inventory write offsGETList inventory write-offs (number, status, location, date), one page at a time; filter by status or search text. Use get_inventory_write_off for the lines.
Me, 1 operation
get_company_settingsGet company settingsGETGet the connected Cin7 Core company: name, base currency, time zone, default units, lock date, tax calculation method, default sale tax rule and discount settings.
Price tier, 1 operation
list_price_tiersList price tiersGETList the account price tiers: the number of each tier and the name it is shown under in sales and products.
Productavailability, 1 operation
list_product_availabilityList product availabilityGETList stock levels per product, location and batch (on hand, allocated, available, on order, in transit), one page at a time; filter by product, SKU, location, batch or category.
Purchase credit note list, 1 operation
list_purchase_credit_notesList purchase credit notesGETList purchase credit notes, one page at a time; filter by search text, updated dates, credit note status or purchase status.
Purchase list, 1 operation
list_purchasesList purchasesGETList purchases (order number, supplier, statuses, totals), one page at a time; filter by search text, dates, order, stock received, invoice, credit note or purchase status. Use get_purchase for detail.
Sale credit note list, 1 operation
list_sale_credit_notesList sale credit notesGETList sale credit notes across all sales, one page at a time; filter by search text, dates, credit note status or sale status.
Sale list, 1 operation
list_salesList salesGETList sales (order and invoice numbers, customer, statuses, amounts), one page at a time; filter by search text, dates, any stage status, external ID or location. Use get_sale for detail.
Ship zones enabled, 1 operation
get_ship_zones_settingGet ship zones settingGETGet whether shipping zones are enabled in the account (IsEnabled).
Stock take list, 1 operation
list_stock_takesList stock takesGETList stock takes (number, status, location, date), one page at a time; filter by status. Use get_stock_take for lines.
Stock transfer list, 1 operation
list_stock_transfersList stock transfersGETList stock transfers between locations, one page at a time; filter by status or search text. Use get_stock_transfer for lines.
Stockadjustment list, 1 operation
list_stock_adjustmentsList stock adjustmentsGETList stock adjustments (number, status, date, account), one page at a time; filter by status. Use get_stock_adjustment for lines.
Template, 1 operation
list_templatesList templatesGETList document templates (ID, type, name and email subject), one page at a time; filter by type or name.
Transaction, 1 operation
list_transactionsList transactionsGETList accounting transactions (journal lines with debit and credit accounts and amounts), one page at a time; filter by effective date range or account code.
Showing the first 120 of 140 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Cin7 Core from Claude Code, Cursor or Codex
Connect Cin7 Core in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Cin7 Core operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Cin7 Core
- Create your workspace
Sign up free. Nothing to install.
- Connect Cin7 Core once
Add your Cin7 Core connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Cin7 Core integration FAQ
What can you do with the Cin7 Core integration?
LiveContext exposes 140 operations on Cin7 Core, covering payment, order, invoice and attributeset.
