Kommo Companies API
The Companies API from Kommo — 2 operation(s) for companies.
The Companies API from Kommo — 2 operation(s) for companies.
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-companies-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 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