Kommo Calls API

The Calls API from Kommo — 1 operation(s) for calls.

GitHub OpenAPI

Operations 1

POST /api/v4/calls Add call note #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kommo:kommo-calls-api"
All apis
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.

Get an API 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 Specification

kommo-calls-api-openapi.yml Raw ↑
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