Kommo Calls API
The Calls API from Kommo — 1 operation(s) for calls.
The Calls API from Kommo — 1 operation(s) for calls.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kommo:kommo-calls-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: kommo-api-references Calls API
version: '1.0'
servers:
- url: https://{subdomain}.kommo.com
variables:
subdomain:
default: subdomain
security:
- sec0: []
tags:
- name: Calls
paths:
/api/v4/calls:
post:
summary: Add call note
description: This method allows adding multiple calls
operationId: add-calls
parameters:
- name: Content-Type
in: header
description: Request header
schema:
type: string
default: application/json
requestBody:
content:
application/json:
schema:
type: object
properties:
RAW_BODY:
type: array
items:
properties:
direction:
type: string
description: Call direction
enum:
- inbound
- outbound
uniq:
type: string
description: Unique call identifier
duration:
type: integer
description: Call duration in seconds
format: int32
source:
type: string
description: Call source (integration name)
link:
type: string
description: Link to the call recording
phone:
type: string
description: The phone number that will be searched.
call_result:
type: string
description: Call result
call_status:
type: integer
description: 'Call status. Available statuses: 1 – left a message, 2 – call back later, 3 – not available, 4 – had a conversation, 5 – invalid phone number, 6 – no connection, 7 – the line is busy.'
format: int32
responsible_user_id:
type: integer
description: ID of the user responsible for the call
format: int32
created_by:
type: integer
description: ID of the user who created the call. If you don't pass a value, you will see in the Stats section that the call was made by a robot.
format: int32
updated_by:
type: integer
description: ID of the user who edited the call last
format: int32
created_at:
type: integer
description: Call creation date in the Unix Timestamp format
format: int32
updated_at:
type: integer
description: Call edit date in the Unix Timestamp format
format: int32
request_id:
type: string
description: Field that will be returned unchanged in the response and will not be saved
call_responsible:
type: string
description: For incoming call – to whom the call was made. For outgoing call – who made the call. You can transfer the Kommo user ID, phone number or name.
required:
- direction
- duration
- source
- phone
type: object
examples:
Request Example:
value:
- duration: 10
source: example_integration
phone: '+1223334444'
link: https://example.com/audio.mp3
direction: inbound
call_result: Discussed the project
call_status: 4
responses:
'200':
description: '200'
content:
application/json:
examples:
Request successful:
value: "{\n \"_total_items\": 1,\n \"errors\": [],\n \"_embedded\": {\n \"calls\": [\n {\n \"id\": 111XXXX,\n \"entity_id\": 123123112,\n \"entity_type\": \"contact\",\n \"account_id\": 123XYZ,\n \"request_id\": \"0\",\n \"_embedded\": {\n \"entity\": {\n \"id\": 321ZYX,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.kommo.com/api/v4/contacts/123123112\"\n }\n }\n }\n }\n }\n ]\n }\n}\n "
'400':
description: '400'
content:
application/json:
examples:
Invalid data are given. Details are available in the response:
value: '{}'
schema:
type: object
properties: {}
'401':
description: '401'
content:
text/plain:
examples:
The user is not authorized:
value: ''
tags:
- Calls
components:
securitySchemes:
sec0:
type: oauth2
flows: {}
x-readme-fauxas: true
x-provenance:
method: searched
source: https://developers.kommo.com/reference
harvested: '2026-11-15'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.kommo.com/reference/accepting-incoming-leads.md
- https://developers.kommo.com/reference/account-parameters.md
- https://developers.kommo.com/reference/activate-users.md
- https://developers.kommo.com/reference/add-call-notifications.md
- https://developers.kommo.com/reference/add-calls.md
- https://developers.kommo.com/reference/add-companies.md
- https://developers.kommo.com/reference/add-contacts.md
- https://developers.kommo.com/reference/add-crm-plugin.md
- https://developers.kommo.com/reference/add-custom-fields.md
- https://developers.kommo.com/reference/add-field-groups.md
- https://developers.kommo.com/reference/add-list-elements.md
- https://developers.kommo.com/reference/add-lists.md
- https://developers.kommo.com/reference/add-notes.md
- https://developers.kommo.com/reference/add-pipelines.md
- https://developers.kommo.com/reference/add-sources.md
- https://developers.kommo.com/reference/add-stages.md
- https://developers.kommo.com/reference/add-tags.md
- https://developers.kommo.com/reference/add-tasks.md
- https://developers.kommo.com/reference/add-templates.md
- https://developers.kommo.com/reference/add-users.md
- https://developers.kommo.com/reference/add-webhooks.md
- https://developers.kommo.com/reference/adding-custom-field.md
- https://developers.kommo.com/reference/adding-leads.md
- https://developers.kommo.com/reference/adding-roles.md
- https://developers.kommo.com/reference/attached-to-entity.md
- https://developers.kommo.com/reference/close-conversation.md
- https://developers.kommo.com/reference/companies-list.md
- https://developers.kommo.com/reference/complex-leads.md
- https://developers.kommo.com/reference/connect-online-chat-to-crm-plugin.md
- https://developers.kommo.com/reference/contacts-list.md
- https://developers.kommo.com/reference/custom-field-by-entity.md
- https://developers.kommo.com/reference/custom-fields-by-id.md
- https://developers.kommo.com/reference/custom-fields-list-of-list.md
- https://developers.kommo.com/reference/deactivate-users.md
- https://developers.kommo.com/reference/declining-incoming-leads.md
- https://developers.kommo.com/reference/delete-a-field-group.md
- https://developers.kommo.com/reference/delete-custom-field.md
- https://developers.kommo.com/reference/delete-pipeline.md
- https://developers.kommo.com/reference/delete-source.md
- https://developers.kommo.com/reference/delete-sources.md
- https://developers.kommo.com/reference/delete-template.md
- https://developers.kommo.com/reference/delete-templates.md
- https://developers.kommo.com/reference/delete-webhook.md
- https://developers.kommo.com/reference/deleting-role.md
- https://developers.kommo.com/reference/deleting-stage.md
- https://developers.kommo.com/reference/detach-files.md
- https://developers.kommo.com/reference/edit-field-groups.md
- https://developers.kommo.com/reference/edit-list-element.md
- https://developers.kommo.com/reference/edit-list-elements.md
- https://developers.kommo.com/reference/edit-note.md
- https://developers.kommo.com/reference/edit-notes.md
- https://developers.kommo.com/reference/edit-pipeline.md
- https://developers.kommo.com/reference/edit-roles.md
- https://developers.kommo.com/reference/edit-stage.md
- https://developers.kommo.com/reference/edit-task.md
- https://developers.kommo.com/reference/edit-tasks.md
- https://developers.kommo.com/reference/edit-template-status.md
- https://developers.kommo.com/reference/edit-templates.md
- https://developers.kommo.com/reference/editing-list.md
- https://developers.kommo.com/reference/editing-lists.md
- https://developers.kommo.com/reference/events-list.md
- https://developers.kommo.com/reference/get-a-fields-group-by-id.md
- https://developers.kommo.com/reference/get-company.md
- https://developers.kommo.com/reference/get-contact-chats.md
- https://developers.kommo.com/reference/get-contact.md
- https://developers.kommo.com/reference/get-conversation-messages.md
- https://developers.kommo.com/reference/get-conversation.md
- https://developers.kommo.com/reference/get-crm-plugin.md
- https://developers.kommo.com/reference/get-entities-with-file.md
- https://developers.kommo.com/reference/get-event.md
- https://developers.kommo.com/reference/get-events-types.md
- https://developers.kommo.com/reference/get-files-entity.md
- https://developers.kommo.com/reference/get-lead-subscribers.md
- https://developers.kommo.com/reference/get-list-crm-plugin.md
- https://developers.kommo.com/reference/get-list-custom-field.md
- https://developers.kommo.com/reference/get-list-element.md
- https://developers.kommo.com/reference/get-list-elements.md
- https://developers.kommo.com/reference/get-list.md
- https://developers.kommo.com/reference/get-lists.md
- https://developers.kommo.com/reference/get-pipeline-by-id.md
- https://developers.kommo.com/reference/get-role-data-by-id.md
- https://developers.kommo.com/reference/get-salesbot-by-id.md
- https://developers.kommo.com/reference/get-source.md
- https://developers.kommo.com/reference/get-sources.md
- https://developers.kommo.com/reference/get-stage.md
- https://developers.kommo.com/reference/get-talks.md
- https://developers.kommo.com/reference/get-template.md
- https://developers.kommo.com/reference/get-templates.md
- https://developers.kommo.com/reference/get-token.md
- https://developers.kommo.com/reference/get-user-by-id.md
- https://developers.kommo.com/reference/getting-a-lead-by-its-id.md
- https://developers.kommo.com/reference/incoming-lead-uid.md
- https://developers.kommo.com/reference/incoming-leads-call.md
- https://developers.kommo.com/reference/incoming-leads-form.md
- https://developers.kommo.com/reference/incoming-leads-list.md
- https://developers.kommo.com/reference/incoming-leads-summary.md
- https://developers.kommo.com/reference/installing-the-widget-into-the-account.md
- https://developers.kommo.com/reference/launch-a-salesbot.md
- https://developers.kommo.com/reference/launch-salesbots.md
- https://developers.kommo.com/reference/leads-list.md
- https://developers.kommo.com/reference/link-chat-contact.md
- https://developers.kommo.com/reference/linked-entities.md
- https://developers.kommo.com/reference/linking-entities.md
- https://developers.kommo.com/reference/linking-incoming-leads.md
- https://developers.kommo.com/reference/list-of-entity-field-groups.md
- https://developers.kommo.com/reference/list-of-entity-tags.md
- https://developers.kommo.com/reference/list-webhooks.md
- https://developers.kommo.com/reference/loss-reason-by-id.md
- https://developers.kommo.com/reference/loss-reasons.md
- https://developers.kommo.com/reference/note-by-id.md
- https://developers.kommo.com/reference/notes-by-entity-id.md
- https://developers.kommo.com/reference/notes-list-entity.md
- https://developers.kommo.com/reference/pin-note.md
- https://developers.kommo.com/reference/pipelines-list.md
- https://developers.kommo.com/reference/salesbot-widget-block-execution-confirmation.md
- https://developers.kommo.com/reference/salesbots-list.md
- https://developers.kommo.com/reference/send-message-to-conversation.md
- https://developers.kommo.com/reference/stages-list.md
- https://developers.kommo.com/reference/stop-salesbot.md
- https://developers.kommo.com/reference/submit-a-whatsapp-template-for-moderation.md
- https://developers.kommo.com/reference/task-id.md
- https://developers.kommo.com/reference/tasks-list.md
- https://developers.kommo.com/reference/uninstall-widget.md
- https://developers.kommo.com/reference/unlinking-entities.md
- https://developers.kommo.com/reference/unpin-note.md
- https://developers.kommo.com/reference/update-companies.md
- https://developers.kommo.com/reference/update-contact.md
- https://developers.kommo.com/reference/update-contacts.md
- https://developers.kommo.com/reference/update-crm-plugin.md
- https://developers.kommo.com/reference/update-custom-field.md
- https://developers.kommo.com/reference/update-custom-fields-list.md
- https://developers.kommo.com/reference/update-custom-fields.md
- https://developers.kommo.com/reference/update-source.md
- https://developers.kommo.com/reference/update-sources.md
- https://developers.kommo.com/reference/update-tags-single-entity.md
- https://developers.kommo.com/reference/update-tags.md
- https://developers.kommo.com/reference/updating-company.md
- https://developers.kommo.com/reference/updating-custom-field-list.md
- https://developers.kommo.com/reference/updating-leads.md
- https://developers.kommo.com/reference/updating-single-lead.md
- https://developers.kommo.com/reference/user-roles-list.md
- https://developers.kommo.com/reference/users-list.md
- https://developers.kommo.com/reference/widget-by-code.md
- https://developers.kommo.com/reference/widgets-list.md
merge:
pages: 144
deduped: 143
conflicts_kept_first: 0