Kommo Connect API

The Connect API from Kommo — 1 operation(s) for connect.

GitHub OpenAPI

Operations 1

POST /{channel_id}/connect Connect chat channel #

Specifications

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-connect-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-connect-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: chats-api Connect API
  version: '1.0'
servers:
- url: https://amojo.kommo.com/v2/origin/custom/
security:
- {}
tags:
- name: Connect
paths:
  /{channel_id}/connect:
    post:
      summary: Connect chat channel
      description: ''
      operationId: connect-channel
      parameters:
      - name: channel_id
        in: path
        description: You get the ID when registering a chat channel
        schema:
          type: string
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                account_id:
                  type: string
                  description: 'Chats API account ID i.e. account: https://developers.kommo.com/reference/chat-api-accountid'
                title:
                  type: string
                  description: Chat channel name
                hook_api_version:
                  type: string
                  description: The Chat API version
                  enum:
                  - v2
                is_time_window_disabled:
                  type: boolean
                  description: Optional. False by default. If you have enabled the channel time window, you can use this parameter to disable it for your account.
              required:
              - account_id
              - title
              - hook_api_version
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                account_id:
                  type: string
                  description: amojo_id that you get in Step 1
                title:
                  type: string
                  description: Bot name
                hook_api_version:
                  type: string
                  description: The Chat API version
                  enum:
                  - v2
          multipart/form-data:
            schema:
              type: object
              properties:
                account_id:
                  type: string
                  description: amojo_id that you get in Step 1
                title:
                  type: string
                  description: Bot name
                hook_api_version:
                  type: string
                  description: The Chat API version
                  enum:
                  - v2
          application/hal+json:
            schema:
              type: object
              properties:
                account_id:
                  type: string
                  description: amojo_id that you get in Step 1
                title:
                  type: string
                  description: Bot name
                hook_api_version:
                  type: string
                  description: The Chat API version
                  enum:
                  - v2
            examples:
              Request Example:
                value:
                  account_id: 52fd2a28-d2eb-4bd8-b862-a67934927b38
                  title: MyKommo
                  hook_api_version: v2
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                Chat channel is successfully connected:
                  value:
                    account_id: 52fd2a28-d2eb-4bd8-b862-b57934927b38
                    scope_id: f62a0162-46a7-430e-b06c-0ef798d56b21_52fd2a28-d2eb-4bd8-b862-b57934927b38
                    title: MyKommo
                    hook_api_version: v2
                    is_time_window_disabled: false
                  summary: Chat channel is successfully connected
              schema:
                type: object
                properties:
                  account_id:
                    type: string
                    example: 52fd2a28-d2eb-4bd8-b862-b57934927b38
                  scope_id:
                    type: string
                    example: f62a0162-46a7-430e-b06c-0ef798d56b21_52fd2a28-d2eb-4bd8-b862-b57934927b38
                  title:
                    type: string
                    example: MyKommo
                  hook_api_version:
                    type: string
                    example: v2
                  is_time_window_disabled:
                    type: boolean
                    example: false
                    default: true
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Incorrect data was transmitted. Details are available in the response body:
                  value:
                    status: 0
                    error_code: 400
                    error_type: VALIDATION_ERROR
                    error_description: 'Validation error: Key: AccountId.Required., Message: AccountId Can not be empty'
                  summary: Incorrect data was transmitted. Details are available in the response body
              schema:
                type: object
                properties: {}
        '403':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Incorrect request signature:
                  summary: Incorrect request signature
                  value:
                    status: 0
                    error_code: 403
                    error_type: ORIGIN_INVALID_SIGNATURE
                    error_description: invalid signature
          description: Forbidden
      tags:
      - Connect
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/chat-history.md
  - https://developers.kommo.com/reference/connect-channel.md
  - https://developers.kommo.com/reference/create-chat.md
  - https://developers.kommo.com/reference/disconnect-channel.md
  - https://developers.kommo.com/reference/send-import-messages.md
  - https://developers.kommo.com/reference/send-reactions.md
  - https://developers.kommo.com/reference/typing-info.md
  - https://developers.kommo.com/reference/update-delivery-status.md
  - https://es-developers.kommo.com/reference/actualizar-el-estado-de-entrega-del-mensaje.md
  - https://es-developers.kommo.com/reference/desconectar-el-canal-de-chat.md
  - https://es-developers.kommo.com/reference/enviar-o-retirar-reacciones.md
  - https://es-developers.kommo.com/reference/obtener-el-historial-del-chat.md
  - https://es-developers.kommo.com/reference/paso-2-conectar-canal-de-chat.md
  - https://es-developers.kommo.com/reference/paso-3-crear-nuevo-chat.md
  - https://es-developers.kommo.com/reference/paso-5-enviar-recibir-o-importar-mensajes.md
  - https://pt-developers.kommo.com/reference/atualizar-status-de-entrega-da-mensagem.md
  - https://pt-developers.kommo.com/reference/conectar-canal-do-chat.md
  - https://pt-developers.kommo.com/reference/criar-novo-chat.md
  - https://pt-developers.kommo.com/reference/desconectar-canal-de-chat.md
  - https://pt-developers.kommo.com/reference/enviar-receber-ou-importar-mensagens.md
  - https://pt-developers.kommo.com/reference/obter-chats-de-contato.md
  merge:
    pages: 21
    deduped: 0
    conflicts_kept_first: 5