Kommo API Documentation
This is the complete API documentation for connecting to the Kommo API using MindCloud's Universal API. If you are new to MindCloud, start with the Introduction to see how one API can sit in front of many different apps.
MindCloud is an integration company that offers one normalized API to access 3,100+ apps from a single place. It cleans up provider-specific quirks, keeps requests and responses consistent, and centralizes authentication so you do not need to manage separate flows for every app. Browse other apps.
Meet Kommo: Manage leads, contacts, pipelines, and sales tasks. Keep reading to get started.
Quickstart
Before you run your first Kommo request, you need three things:
- A MindCloud account — sign in or create an account at MindCloud.
- A MindCloud API Key — create one in API Keys. Keep it on your server.
- At least one Kommo connection — create or choose one in Connections. Note its
connectionId.
Every Kommo action uses the same URL pattern:
https://connect.mindcloud.co/v1/universal/kommo/latest/actions/{actionSlug}You need a MindCloud API Key and a Kommo connection. Then call an action such as Get Account:
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/kommo/latest/actions/get-account" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID"Every response comes back in the same envelope, with your rows in a data array:
{
"success": true,
"data": [
{ "id": "1042", "name": "Ava" }
],
"meta": {}
}After your first request works, use Shape your requests to control arguments, pagination, filtering, fields, and errors.
Authentication
Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected Kommo account that should run the action. MindCloud stores and refreshes the Kommo credentials behind that connection, so you never send provider tokens with your requests.
Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions. Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs.
Kommo actions
All 137 published actions for this Kommo version. Each page documents the endpoint, arguments, and response controls.
- PUTAccept Incoming Lead
- POSTAttach Entity File
- PUTBulk Update Catalog Custom Fields
- PUTBulk Update Catalog Elements
- PUTBulk Update Catalogs
- PUTBulk Update Chat Templates
- PUTBulk Update Companies
- PUTBulk Update Contacts
- PUTBulk Update Custom Fields
- PUTBulk Update Entity Tags
- PUTBulk Update Leads
- PUTBulk Update Notes
- PUTBulk Update Sources
- PUTBulk Update Tasks
- PUTClose Talk
- PUTContinue Salesbot
- POSTCreate Call
- POSTCreate Catalog
- POSTCreate Catalog Custom Field
- POSTCreate Catalog Element
- POSTCreate Chat Template
- POSTCreate Company
- POSTCreate Complex Lead
- POSTCreate Contact
- POSTCreate Contact Chat
- POSTCreate Custom Field
- POSTCreate Custom Field Group
- POSTCreate Event
- POSTCreate Incoming Call Lead
- POSTCreate Incoming Form Lead
- POSTCreate Lead
- POSTCreate Note
- POSTCreate Pipeline
- POSTCreate Pipeline Stage
- POSTCreate Role
- POSTCreate Source
- POSTCreate Tag
- POSTCreate Task
- POSTCreate User
- POSTCreate Webhook
- POSTCreate Website Button
- POSTCreate Website Button Online Chat
- DELETEDecline Incoming Lead
- DELETEDelete Chat Template
- DELETEDelete Chat Templates
- DELETEDelete Custom Field
- DELETEDelete Custom Field Group
- DELETEDelete Pipeline
- DELETEDelete Pipeline Stage
- DELETEDelete Role
- DELETEDelete Source
- DELETEDelete Sources
- DELETEDelete Webhooks
- DELETEDelete Widget
- DELETEDetach Entity File
- GETGet Account
- GETGet Catalog
- GETGet Catalog Custom Field
- GETGet Catalog Element
- GETGet Chat Template
- GETGet Company
- GETGet Contact
- GETGet Custom Field
- GETGet Custom Field Group
- GETGet Event
- GETGet Incoming Lead
- GETGet Incoming Leads Summary
- GETGet Lead
- GETGet Loss Reason
- GETGet Note
- GETGet Pipeline
- GETGet Pipeline Stage
- GETGet Role
- GETGet Source
- GETGet Talk
- GETGet Task
- GETGet User
- GETGet Website Button
- GETGet Widget
- POSTInstall Widget
- POSTLink Entity
- PUTLink Incoming Lead
- GETList Bots
- GETList Catalog Custom Fields
- GETList Catalog Elements
- GETList Catalogs
- GETList Chat Templates
- GETList Companies
- GETList Contact Chats
- GETList Contacts
- GETList Custom Field Groups
- GETList Custom Fields
- GETList Entity Files
- GETList Entity Links
- GETList Event Types
- GETList Events
- GETList File Links
- GETList Incoming Leads
- GETList Leads
- GETList Loss Reasons
- GETList Notes
- GETList Notes For Entity
- GETList Pipeline Stages
- GETList Pipelines
- GETList Roles
- GETList Sources
- GETList Tags
- GETList Tasks
- GETList Users
- GETList Webhooks
- GETList Website Buttons
- GETList Widgets
- PUTPin Note
- POSTRun Bot
- POSTRun Bots
- POSTRun Salesbot
- PUTStop Bot
- PUTSubmit Chat Template For Review
- DELETEUnlink Entity
- PUTUnpin Note
- PUTUpdate Catalog
- PUTUpdate Catalog Custom Field
- PUTUpdate Catalog Element
- PUTUpdate Chat Template Review
- PUTUpdate Company
- PUTUpdate Contact
- PUTUpdate Custom Field
- PUTUpdate Custom Field Group
- PUTUpdate Entity Tags
- PUTUpdate Lead
- PUTUpdate Note
- PUTUpdate Pipeline
- PUTUpdate Pipeline Stage
- PUTUpdate Role
- PUTUpdate Source
- PUTUpdate Task
- PUTUpdate Website Button
Related apps
More Sales & CRM apps on the Universal API, behind the same REST shape. Or browse all apps.