# Kommo API Documentation

This is the complete API documentation for connecting to the Kommo API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Kommo connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/kommo/actions/{actionSlug}/run
```

## Kommo actions

- PUT `accept-incoming-lead` Accept Incoming Lead
- POST `attach-entity-file` Attach Entity File
- PUT `bulk-update-catalog-custom-fields` Bulk Update Catalog Custom Fields
- PUT `bulk-update-catalog-elements` Bulk Update Catalog Elements
- PUT `bulk-update-catalogs` Bulk Update Catalogs
- PUT `bulk-update-chat-templates` Bulk Update Chat Templates
- PUT `bulk-update-companies` Bulk Update Companies
- PUT `bulk-update-contacts` Bulk Update Contacts
- PUT `bulk-update-custom-fields` Bulk Update Custom Fields
- PUT `bulk-update-entity-tags` Bulk Update Entity Tags
- PUT `bulk-update-leads` Bulk Update Leads
- PUT `bulk-update-notes` Bulk Update Notes
- PUT `bulk-update-sources` Bulk Update Sources
- PUT `bulk-update-tasks` Bulk Update Tasks
- PUT `close-talk` Close Talk
- PUT `continue-salesbot` Continue Salesbot
- POST `create-call` Create Call
- POST `create-catalog` Create Catalog
- POST `create-catalog-custom-field` Create Catalog Custom Field
- POST `create-catalog-element` Create Catalog Element
- POST `create-chat-template` Create Chat Template
- POST `create-company` Create Company
- POST `create-complex-lead` Create Complex Lead
- POST `create-contact` Create Contact
- POST `create-contact-chat` Create Contact Chat
- POST `create-custom-field` Create Custom Field
- POST `create-custom-field-group` Create Custom Field Group
- POST `create-event` Create Event
- POST `create-incoming-call-lead` Create Incoming Call Lead
- POST `create-incoming-form-lead` Create Incoming Form Lead
- POST `create-lead` Create Lead
- POST `create-note` Create Note
- POST `create-pipeline` Create Pipeline
- POST `create-pipeline-stage` Create Pipeline Stage
- POST `create-role` Create Role
- POST `create-source` Create Source
- POST `create-tag` Create Tag
- POST `create-task` Create Task
- POST `create-user` Create User
- POST `create-webhook` Create Webhook
- POST `create-website-button` Create Website Button
- POST `create-website-button-online-chat` Create Website Button Online Chat
- DELETE `decline-incoming-lead` Decline Incoming Lead
- DELETE `delete-chat-template` Delete Chat Template
- DELETE `delete-chat-templates` Delete Chat Templates
- DELETE `delete-custom-field` Delete Custom Field
- DELETE `delete-custom-field-group` Delete Custom Field Group
- DELETE `delete-pipeline` Delete Pipeline
- DELETE `delete-pipeline-stage` Delete Pipeline Stage
- DELETE `delete-role` Delete Role
- DELETE `delete-source` Delete Source
- DELETE `delete-sources` Delete Sources
- DELETE `delete-webhooks` Delete Webhooks
- DELETE `delete-widget` Delete Widget
- DELETE `detach-entity-file` Detach Entity File
- GET `get-account` Get Account
- GET `get-catalog` Get Catalog
- GET `get-catalog-custom-field` Get Catalog Custom Field
- GET `get-catalog-element` Get Catalog Element
- GET `get-chat-template` Get Chat Template
- GET `get-company` Get Company
- GET `get-contact` Get Contact
- GET `get-custom-field` Get Custom Field
- GET `get-custom-field-group` Get Custom Field Group
- GET `get-event` Get Event
- GET `get-incoming-lead` Get Incoming Lead
- GET `get-incoming-leads-summary` Get Incoming Leads Summary
- GET `get-lead` Get Lead
- GET `get-loss-reason` Get Loss Reason
- GET `get-note` Get Note
- GET `get-pipeline` Get Pipeline
- GET `get-pipeline-stage` Get Pipeline Stage
- GET `get-role` Get Role
- GET `get-source` Get Source
- GET `get-talk` Get Talk
- GET `get-task` Get Task
- GET `get-user` Get User
- GET `get-website-button` Get Website Button
- GET `get-widget` Get Widget
- POST `install-widget` Install Widget
- POST `link-entity` Link Entity
- PUT `link-incoming-lead` Link Incoming Lead
- GET `list-bots` List Bots
- GET `list-catalog-custom-fields` List Catalog Custom Fields
- GET `list-catalog-elements` List Catalog Elements
- GET `list-catalogs` List Catalogs
- GET `list-chat-templates` List Chat Templates
- GET `list-companies` List Companies
- GET `list-contact-chats` List Contact Chats
- GET `list-contacts` List Contacts
- GET `list-custom-field-groups` List Custom Field Groups
- GET `list-custom-fields` List Custom Fields
- GET `list-entity-files` List Entity Files
- GET `list-entity-links` List Entity Links
- GET `list-event-types` List Event Types
- GET `list-events` List Events
- GET `list-file-links` List File Links
- GET `list-incoming-leads` List Incoming Leads
- GET `list-leads` List Leads
- GET `list-loss-reasons` List Loss Reasons
- GET `list-notes` List Notes
- GET `list-notes-for-entity` List Notes For Entity
- GET `list-pipeline-stages` List Pipeline Stages
- GET `list-pipelines` List Pipelines
- GET `list-roles` List Roles
- GET `list-sources` List Sources
- GET `list-tags` List Tags
- GET `list-tasks` List Tasks
- GET `list-users` List Users
- GET `list-webhooks` List Webhooks
- GET `list-website-buttons` List Website Buttons
- GET `list-widgets` List Widgets
- PUT `pin-note` Pin Note
- POST `run-bot` Run Bot
- POST `run-bots` Run Bots
- POST `run-salesbot` Run Salesbot
- PUT `stop-bot` Stop Bot
- PUT `submit-chat-template-for-review` Submit Chat Template For Review
- DELETE `unlink-entity` Unlink Entity
- PUT `unpin-note` Unpin Note
- PUT `update-catalog` Update Catalog
- PUT `update-catalog-custom-field` Update Catalog Custom Field
- PUT `update-catalog-element` Update Catalog Element
- PUT `update-chat-template-review` Update Chat Template Review
- PUT `update-company` Update Company
- PUT `update-contact` Update Contact
- PUT `update-custom-field` Update Custom Field
- PUT `update-custom-field-group` Update Custom Field Group
- PUT `update-entity-tags` Update Entity Tags
- PUT `update-lead` Update Lead
- PUT `update-note` Update Note
- PUT `update-pipeline` Update Pipeline
- PUT `update-pipeline-stage` Update Pipeline Stage
- PUT `update-role` Update Role
- PUT `update-source` Update Source
- PUT `update-task` Update Task
- PUT `update-website-button` Update Website Button