Kommo Companies API

The Companies API from Kommo — 2 operation(s) for companies.

GitHub OpenAPI

Operations 5

GET /api/v4/companies Companies list #
POST /api/v4/companies Add companies #
PATCH /api/v4/companies Updating companies #
GET /api/v4/companies/{id} Get company by ID #
PATCH /api/v4/companies/{id} Update company #

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-companies-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-companies-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: kommo-api-references Companies API
  version: '1.0'
servers:
- url: https://{subdomain}.kommo.com
  variables:
    subdomain:
      default: subdomain
security:
- sec0: []
tags:
- name: Companies
paths:
  /api/v4/companies:
    get:
      summary: Companies list
      description: The method allows you to get a list of companies
      operationId: companies-list
      parameters:
      - name: with
        in: query
        description: This parameter takes a string that may consist of several values separated by commas. See the table above.
        schema:
          type: string
      - name: page
        in: query
        description: Page of response
        schema:
          type: integer
          format: int32
      - name: limit
        in: query
        description: The number of the entities returned in the response to one request (limit – 250)
        schema:
          type: integer
          format: int32
      - name: query
        in: query
        description: Search query (will perform a search by custom fields values)
        schema:
          type: string
      - name: order[updated_at]
        in: query
        description: List elements sorting by the time companies were updated at
        schema:
          type: string
          enum:
          - asc
          - desc
      - name: order[id]
        in: query
        description: List elements sorting by companies IDs
        schema:
          type: string
          enum:
          - asc
          - desc
      - name: filter[id][]
        in: query
        description: Filter by company ID
        schema:
          type: array
          items:
            type: integer
            format: int32
      - name: filter[name][]
        in: query
        description: Filter by company name
        schema:
          type: array
          items:
            type: string
      - name: filter[created_by][]
        in: query
        description: Filter by ID of the user who added the company.
        schema:
          type: array
          items:
            type: integer
            format: int32
      - name: filter[updated_by][]
        in: query
        description: Filter by ID of the user who updated the company last
        schema:
          type: array
          items:
            type: integer
            format: int32
      - name: filter[responsible_user_id][]
        in: query
        description: Filter by ID of the company responsible user
        schema:
          type: array
          items:
            type: integer
            format: int32
      - name: filter[created_at][from]
        in: query
        description: Filter by the creation date of the company in Unix Timestamp format. As a response you will get all the companies added after the date.
        schema:
          type: integer
          format: int32
      - name: filter[created_at][to]
        in: query
        description: Filter by the creation date of the company in Unix Timestamp format. As a response you will get all the companies added before the date.
        schema:
          type: integer
          format: int32
      - name: filter[updated_at][from]
        in: query
        description: Filter by date in Unix Timestamp format when the company was updated. As a response you will get all the companies updated after the date.
        schema:
          type: integer
          format: int32
      - name: filter[updated_at][to]
        in: query
        description: Filter by date in Unix Timestamp format when the company was updated. As a response you will get all the companies updated before the date.
        schema:
          type: integer
          format: int32
      - name: filter[closest_task_at][from]
        in: query
        description: Filter leads by the date of the task closest to completion in Unix Timestamp format.
        schema:
          type: integer
          format: int32
      - name: filter[closest_task_at][to]
        in: query
        description: Filter leads by the date of the task closest to completion in Unix Timestamp format.
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Request successful:
                  value: "{\n    \"_page\": 1,\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://subdomain.kommo.com/api/v4/companies\"\n        }\n    },\n    \"_embedded\": {\n        \"companies\": [\n            {\n                \"id\": XXXXXX,\n                \"name\": \"United\",\n                \"responsible_user_id\": XXXXXX,\n                \"group_id\": 0,\n                \"created_by\": XXXXX,\n                \"updated_by\": XXXXXX,\n                \"created_at\": 1686670709,\n                \"updated_at\": 1686670709,\n                \"closest_task_at\": null,\n                \"is_deleted\": false,\n                \"custom_fields_values\": null,\n                \"account_id\": XXXX123,\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://subdomain.kommo.com/api/v4/companies/406320\"\n                    }\n                },\n                \"_embedded\": {\n                    \"tags\": []\n                }\n            },\n            {\n                \"id\": 510XXX,\n                \"name\": \"Kommo\",\n                \"responsible_user_id\": 837XYZ,\n                \"group_id\": 0,\n                \"created_by\": 0,\n                \"updated_by\": 0,\n                \"created_at\": 1686754687,\n                \"updated_at\": 1686754687,\n                \"closest_task_at\": null,\n                \"is_deleted\": false,\n                \"custom_fields_values\": null,\n                \"account_id\": XYZ11263,\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://subdomain.kommo.com/api/v4/companies/510864\"\n                    }\n                },\n                \"_embedded\": {\n                    \"tags\": []\n                }\n            },\n            {\n                \"id\": 597XXX,\n                \"name\": \"Atme Co.\",\n                \"responsible_user_id\": 0,\n                \"group_id\": -1,\n                \"created_by\": 0,\n                \"updated_by\": 0,\n                \"created_at\": 1686836351,\n                \"updated_at\": 1686836351,\n                \"closest_task_at\": null,\n                \"is_deleted\": false,\n                \"custom_fields_values\": null,\n                \"account_id\": 3136XXXX,\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://subdomain.kommo.com/api/v4/companies/597516\"\n                    }\n                },\n                \"_embedded\": {\n                    \"tags\": []\n                }\n            }\n        ]\n    }\n}"
        '401':
          description: '401'
          content:
            application/json:
              examples:
                The user is not authorized:
                  value: ''
      tags:
      - Companies
    post:
      summary: Add companies
      description: This method allows adding one or more companies into the account
      operationId: add-companies
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                RAW_BODY:
                  type: array
                  items:
                    properties:
                      id:
                        type: integer
                        description: Company ID
                        format: int32
                      name:
                        type: string
                        description: Company name
                      responsible_user_id:
                        type: integer
                        description: Company responsible user ID
                        format: int32
                      created_by:
                        type: integer
                        description: The ID of the user who created the company
                        format: int32
                      updated_by:
                        type: integer
                        description: The ID of the user who updated the company last
                        format: int32
                      created_at:
                        type: integer
                        description: Company creation date in the format of Unix Timestamp
                        format: int32
                      updated_at:
                        type: integer
                        description: Company update date in the format of Unix Timestamp
                        format: int32
                      custom_fields_values:
                        type: string
                        description: An array of the current company custom fields’ values.
                        format: json
                      _embedded:
                        type: object
                        properties:
                          tags:
                            type: array
                            items:
                              properties:
                                id:
                                  type: integer
                                  description: Tag ID
                                  format: int32
                                name:
                                  type: string
                                  description: Tag name
                              type: object
                      request_id:
                        type: string
                        description: The field will be returned unchanged in the response and will not be saved.
                      tags_to_add:
                        type: array
                        description: Array of tags to add. Either ID or tag name must be passed.
                        items:
                          properties:
                            id:
                              type: integer
                              description: Tag ID
                              format: int32
                            name:
                              type: string
                              description: Tag name
                          type: object
                    type: object
            examples:
              Request Example:
                value:
                - name: Acme Co.
                  custom_fields_values:
                  - field_code: PHONE
                    values:
                    - value: '+18305803077'
                      enum_code: WORK
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Companies have been created successfully:
                  value: "{\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://devteam.kommo.com/api/v4/companies\"\n        }\n    },\n    \"_embedded\": {\n        \"companies\": [\n            {\n                \"id\": 1247556,\n                \"is_deleted\": false,\n                \"request_id\": \"0\",\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://devteam.kommo.com/api/v4/companies/1247556\"\n                    }\n                }\n            }\n        ]\n    }\n}"
              schema:
                type: object
                properties:
                  _links:
                    type: object
                    properties:
                      self:
                        type: object
                        properties:
                          href:
                            type: string
                            example: https://devteam.kommo.com/api/v4/companies
                  _embedded:
                    type: object
                    properties:
                      companies:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              example: 1247556
                              default: 0
                            is_deleted:
                              type: boolean
                              example: false
                              default: true
                            request_id:
                              type: string
                              example: '0'
                            _links:
                              type: object
                              properties:
                                self:
                                  type: object
                                  properties:
                                    href:
                                      type: string
                                      example: https://devteam.kommo.com/api/v4/companies/1247556
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid data is given. Details are available in the request-response:
                  value: '{}'
              schema:
                type: object
                properties: {}
        '401':
          description: '401'
          content:
            text/plain:
              examples:
                The user is not authorized:
                  value: ''
      deprecated: false
      tags:
      - Companies
    patch:
      summary: Updating companies
      description: This method allows updating multiple companies. An array of objects is passed.
      operationId: update-companies
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                RAW_BODY:
                  type: array
                  items:
                    properties:
                      id:
                        type: integer
                        description: Company ID
                        format: int32
                      name:
                        type: string
                        description: Company name
                      responsible_user_id:
                        type: integer
                        description: Company responsible user ID
                        format: int32
                      created_by:
                        type: integer
                        description: The ID of the user who created the company
                        format: int32
                      updated_by:
                        type: integer
                        description: The ID of the user who updated the company last
                        format: int32
                      created_at:
                        type: integer
                        description: Company creation date in the format of Unix Timestamp
                        format: int32
                      updated_at:
                        type: integer
                        description: Company update date in the format of Unix Timestamp
                        format: int32
                      custom_fields_values:
                        type: string
                        description: An array of the current company custom fields’ values.
                        format: json
                      _embedded:
                        type: object
                        properties:
                          tags:
                            type: array
                            items:
                              properties:
                                id:
                                  type: integer
                                  description: Tag ID
                                  format: int32
                                name:
                                  type: string
                                  description: Tag name
                              type: object
                      request_id:
                        type: string
                        description: The field will be returned unchanged in the response and will not be saved.
                      tags_to_add:
                        type: array
                        description: Array of tags to add. You need to pass either name or ID of the tag.
                        items:
                          properties:
                            id:
                              type: integer
                              description: Tag ID
                              format: int32
                            name:
                              type: string
                              description: Tag name
                          type: object
                      tags_to_delete:
                        type: array
                        description: Array of tags to delete. Either ID or tag name must be passed.
                        items:
                          properties:
                            id:
                              type: integer
                              description: Tag ID
                            name:
                              type: string
                              description: Tag name
                          type: object
                    type: object
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Companies have been updated successfully:
                  value: "{\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://subdomain.kommo.com/api/v4/companies\"\n        }\n    },\n    \"_embedded\": {\n        \"companies\": [\n            {\n                \"id\": 123XXXX,\n                \"name\": \"Atlas Co.\",\n                \"updated_at\": 1687335927,\n                \"is_deleted\": false,\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://subdomain.kommo.com/api/v4/companies/1247556\"\n                    }\n                }\n            }\n        ]\n    }\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid data is 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: ''
      deprecated: false
      tags:
      - Companies
  /api/v4/companies/{id}:
    get:
      summary: Get company by ID
      description: This method allows to get a particular company data by its ID
      operationId: get-company
      parameters:
      - name: with
        in: query
        description: This parameter takes a string that may consist of several values separated by commas. See the table above.
        schema:
          type: string
      - name: id
        in: path
        description: Company ID
        schema:
          type: integer
          format: int32
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Request successful:
                  value: "{\n    \"id\": 123XYZ,\n    \"name\": \"United\",\n    \"responsible_user_id\": 837XXXX,\n    \"group_id\": 0,\n    \"created_by\": 837XXXX,\n    \"updated_by\": 837XXXX,\n    \"created_at\": 1686670709,\n    \"updated_at\": 1686670709,\n    \"closest_task_at\": null,\n    \"is_deleted\": false,\n    \"custom_fields_values\": null,\n    \"account_id\": 3123123,\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://subdomain.kommo.com/api/v4/companies/406320\"\n        }\n    },\n    \"_embedded\": {\n        \"tags\": []\n    }\n}"
        '204':
          description: '204'
          content:
            text/plain:
              examples:
                The company with the specified ID does not exist:
                  value: ''
        '401':
          description: '401'
          content:
            application/json:
              examples:
                The user is not authorized:
                  value: ''
      tags:
      - Companies
    patch:
      summary: Update company
      description: This method allows updating a singular company (an object is passed)
      operationId: updating-company
      parameters:
      - name: id
        in: path
        description: Company ID
        schema:
          type: integer
          format: int32
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                RAW_BODY:
                  type: object
                  properties:
                    name:
                      type: string
                      description: Company name
                    responsible_user_id:
                      type: integer
                      description: Company responsible user ID
                      format: int32
                    created_by:
                      type: integer
                      description: The ID of the user who created the company
                      format: int32
                    updated_by:
                      type: integer
                      description: The ID of the user who updated the company last
                      format: int32
                    created_at:
                      type: integer
                      description: Company creation date in the format of Unix Timestamp
                      format: int32
                    updated_at:
                      type: integer
                      description: Company update date in the format of Unix Timestamp
                      format: int32
                    custom_fields_values:
                      type: string
                      description: An array of the current company custom fields’ values.
                      format: json
                    _embedded:
                      type: object
                      properties:
                        tags:
                          type: array
                          items:
                            properties:
                              id:
                                type: integer
                                description: Tag ID
                                format: int32
                              name:
                                type: string
                                description: Tag name
                            type: object
                    request_id:
                      type: string
                      description: The field will be returned unchanged in the response and will not be saved.
                    tags_to_add:
                      type: array
                      description: Array of tags to add. You need to pass either name or ID of the tag.
                      items:
                        properties:
                          id:
                            type: integer
                            description: Tag ID
                            format: int32
                          name:
                            type: string
                            description: Tag name
                        type: object
                    tags_to_delete:
                      type: array
                      description: Array of tags to delete. Either ID or tag name must be passed.
                      items:
                        properties:
                          id:
                            type: integer
                            description: Tag ID
                          name:
                            type: string
                            description: Tag name
                        type: object
            examples:
              Request Example:
                value:
                  name: Atlas Co.
                  custom_fields_values:
                  - field_code: EMAIL
                    values:
                    - value: support@atlas.com
                      enum_code: WORK
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Companies have been updated successfully:
                  value: "{\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://subdomain.kommo.com/api/v4/companies\"\n        }\n    },\n    \"_embedded\": {\n        \"companies\": [\n            {\n                \"id\": 123XXXX,\n                \"name\": \"Atlas Co.\",\n                \"updated_at\": 1687335927,\n                \"is_deleted\": false,\n                \"_links\": {\n                    \"self\": {\n                        \"href\": \"https://subdomain.kommo.com/api/v4/companies/1247556\"\n                    }\n                }\n            }\n        ]\n    }\n}"
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Invalid data is 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:
      - Companies
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


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/kommo/openapi/kommo-companies-api-openapi.yml