# Kommo

Kommo CRM is a platform for managing customer relationships, sales pipelines, and business processes.

- **Category:** crm
- **Auth:** OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 53
- **Triggers:** 0
- **Slug:** `KOMMO`
- **Version:** 20260312_00

## Tools

### Add AI Source File

**Slug:** `KOMMO_ADD_AI_SOURCE_FILE`

Tool to add a knowledge source file to Kommo AI. Use when you need to upload a file (like documentation, policies, or knowledge base articles) to be used by the Kommo AI agent or suggested reply feature.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | HTTP or HTTPS protocol link to the Kommo drive service with the path to the file. |
| `code` | string ("contact_information" | "privacy_policy" | "return_and_refund_policy" | "shipping_policy" | "terms_of_service") | No | Valid source code values that categorize source usage. |
| `lang` | string ("en" | "es" | "pt" | "ru") | Yes | Language of the file content. Supported values: en (English), es (Spanish), pt (Portuguese), ru (Russian). |
| `file_uuid` | string | Yes | UUID of the file. It is included in the file path, but must be provided here as well. |
| `available_functions` | array | Yes | Defines which functionality will use the source. Must contain exactly one value: either 'agent' or 'suggested_reply'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Kommo Companies

**Slug:** `KOMMO_CREATE_COMPANY`

Action to add one or more companies into the Kommo account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Company name |
| `created_at` | integer | No | Company creation date (Unix Timestamp) |
| `created_by` | integer | No | ID of the user who created the company |
| `request_id` | string | No | This field will be returned unchanged in the response |
| `updated_at` | integer | No | Company update date (Unix Timestamp) |
| `updated_by` | integer | No | ID of the user who last updated the company |
| `tags_to_add` | array | No | Array of tags to add. Provide either tag name or ID |
| `responsible_user_id` | integer | No | Company responsible user ID |
| `custom_fields_values` | array | No | An array of the current company custom fields' values |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Kommo Contact

**Slug:** `KOMMO_CREATE_CONTACT`

Action to create one or more contacts in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contacts` | array | Yes | List of contacts to create |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Kommo Lead

**Slug:** `KOMMO_CREATE_LEAD`

Action to create a lead in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the lead/deal |
| `price` | integer | No | Lead sale amount (deal value) |
| `closed_at` | integer | No | Lead closure date (Unix Timestamp) |
| `status_id` | integer | No | Stage ID the lead is added to. The first stage of the main pipeline by default |
| `created_at` | integer | No | Lead creation date (Unix Timestamp) |
| `created_by` | integer | No | The ID of the user creating the lead. When passing 0, lead will be created by robot |
| `updated_at` | integer | No | Lead update date (Unix Timestamp) |
| `updated_by` | integer | No | The ID of the user updating the lead. When passing 0, lead will be updated by robot |
| `pipeline_id` | integer | No | Pipeline ID the lead is added to |
| `tags_to_add` | array | No | Array of tags to add. Provide either tag name or ID |
| `loss_reason_id` | integer | No | Lead loss reason ID |
| `tags_to_delete` | array | No | Array of tags to delete. Provide either tag name or ID |
| `responsible_user_id` | integer | No | Lead responsible user ID |
| `custom_fields_values` | array | No | An array of the current lead custom fields' values |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Kommo Task

**Slug:** `KOMMO_CREATE_TASK`

Action to create a task in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | Yes | Task description or notes. This field is required. |
| `duration` | integer | No | Task duration in seconds |
| `entity_id` | integer | Yes | ID of the entity (lead, contact, or company) the task is linked to |
| `created_at` | integer | No | Task creation date in Unix Timestamp format |
| `created_by` | integer | No | ID of the user who created the task |
| `updated_at` | integer | No | Task edit date in Unix Timestamp format |
| `updated_by` | integer | No | ID of the user who edited the task last |
| `entity_type` | string | Yes | Type of the entity the task is linked to. Valid values: 'leads', 'contacts', 'companies' |
| `task_type_id` | integer | No | Task type |
| `complete_till` | integer | Yes | Task deadline date in Unix Timestamp format. Required for all tasks. |
| `responsible_user_id` | integer | No | Task responsible user ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Kommo Files

**Slug:** `KOMMO_DELETE_FILES`

Tool to delete files (move to trash) in Kommo. Use when you need to remove files from the Kommo account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | Yes | List of files to delete (move to trash). Each file must have a UUID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Account

**Slug:** `KOMMO_GET_ACCOUNT`

Tool to get account information including user data, custom fields, task types, user groups, amojo rights, and integration status. Use when you need to retrieve account-level details from Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `with_params` | string | No | Comma-separated list of additional data to include in the response. Valid values: 'amojo_id', 'amojo_rights', 'users_groups', 'task_types', 'version', 'entity_names', 'datetime_settings'. Example: 'users_groups,task_types' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Company

**Slug:** `KOMMO_GET_COMPANY`

Tool to get a company by its ID from Kommo CRM. Use when you need to retrieve detailed information about a specific company including its name, responsible user, and optionally embedded data like contacts, leads, or catalog elements.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The company identifier to retrieve |
| `with_params` | string | No | Comma-separated string of values for embedded data inclusion. Example: 'contacts,leads' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Contact

**Slug:** `KOMMO_GET_CONTACT`

Tool to get a specific contact by its ID from Kommo CRM. Use when you need to retrieve detailed information about a particular contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the contact to retrieve. |
| `with_params` | array | No | Additional embedded data to include in response. Supported values: 'leads' (include linked leads), 'catalog_elements' (include linked catalog items). Multiple values can be provided as a list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Custom Field

**Slug:** `KOMMO_GET_CUSTOM_FIELD`

Tool to retrieve a custom field by its ID from Kommo CRM. Use when you need detailed information about a specific custom field including its type, settings, and enum values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The custom field identifier to retrieve |
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | The type of entity to fetch the custom field for. Valid values: 'leads', 'contacts', 'companies' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Event

**Slug:** `KOMMO_GET_EVENT`

Tool to get a specific event by its ID from Kommo CRM. Use when you need to retrieve detailed information about a particular event, including before/after state changes for entities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique event identifier. Use LIST_EVENTS action to get available event IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Field Group

**Slug:** `KOMMO_GET_FIELD_GROUP`

Tool to retrieve a custom field group by its ID from Kommo CRM. Use when you need to get details about a specific field group including its fields and metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The field group ID to retrieve. Can be a numeric ID or 'default' for the default group |
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | The type of entity to fetch the field group for. Valid values: 'leads', 'contacts', 'companies' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get File Links

**Slug:** `KOMMO_GET_FILE_LINKS`

Tool to get entities associated with a file in Kommo. Use when you need to find which leads, contacts, companies, or catalog elements are linked to a specific file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_uuid` | string | Yes | The unique identifier (UUID) of the file for which to retrieve associated entities |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Incoming Leads Summary

**Slug:** `KOMMO_GET_INCOMING_LEADS_SUMMARY`

Tool to retrieve summary statistics for incoming (unsorted) leads in Kommo CRM. Use when you need aggregate metrics like total count, acceptance/decline rates, average processing time, and breakdown by lead source category.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter_uid` | array | No | Filter by specific incoming lead unique identifiers. Provide an array of UID strings to retrieve summary for specific incoming leads only. |
| `filter_created_at` | integer | No | Filter by creation date threshold (Unix timestamp). Returns incoming leads created after this timestamp. |
| `filter_pipeline_id` | integer | No | Filter by specific pipeline ID. Returns summary for incoming leads in the specified pipeline only. |
| `filter_created_at_to` | integer | No | Creation date range end (Unix timestamp). Use together with filter_created_at_from to define a date range. |
| `filter_created_at_from` | integer | No | Creation date range start (Unix timestamp). Use together with filter_created_at_to to define a date range. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Lead

**Slug:** `KOMMO_GET_LEAD`

Tool to get a lead by its ID from Kommo CRM. Use when you need to retrieve detailed information about a specific lead including its status, price, responsible user, and optionally embedded data like contacts, catalog elements, or loss reasons.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The lead identifier to retrieve |
| `with_params` | string | No | Comma-separated string of values for embedded data inclusion. Valid values: 'contacts', 'catalog_elements', 'loss_reason', 'source_id', 'is_price_modified_by_robot'. Example: 'contacts,catalog_elements' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Loss Reason

**Slug:** `KOMMO_GET_LOSS_REASON`

Tool to retrieve a specific loss reason by its ID from Kommo CRM. Use when you need detailed information about a particular loss reason, such as its name, sort order, and timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the loss reason to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Pipeline

**Slug:** `KOMMO_GET_PIPELINE`

Tool to get a pipeline by its ID from Kommo CRM. Use when you need to retrieve details about a specific pipeline including its stages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Pipeline identifier |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Pipeline Status

**Slug:** `KOMMO_GET_PIPELINE_STATUS`

Tool to get a specific pipeline stage by its ID from Kommo CRM. Use when you need to retrieve detailed information about a particular stage within a pipeline.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The stage ID to retrieve |
| `pipeline_id` | integer | Yes | The ID of the pipeline containing the stage |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Task

**Slug:** `KOMMO_GET_TASK`

Tool to retrieve a task by its ID from Kommo CRM. Use when you need to fetch details of a specific task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the task to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo User

**Slug:** `KOMMO_GET_USER`

Tool to retrieve user data by its ID from Kommo CRM. Use when you need to fetch details about a specific user including their name, email, role, group, and access rights.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the user to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Kommo Widget Info

**Slug:** `KOMMO_GET_WIDGET`

Tool to get detailed information about a widget by its code. Use when you need to retrieve widget metadata, settings, version, or check if a widget is active in the account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | Yes | The unique code identifier for the widget (e.g., 'amo_dropbox', 'mailchimp') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import Products to AI

**Slug:** `KOMMO_IMPORT_PRODUCTS_TO_AI`

Tool to launch import of products from CRM to AI knowledge base. Use when you need to initiate the process of importing product data into the AI system for enhanced product recommendations and knowledge.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string ("en" | "es" | "pt" | "ru") | No | Supported language codes for API responses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Catalogs

**Slug:** `KOMMO_LIST_CATALOGS`

Tool to retrieve a list of catalogs (lists) from Kommo CRM. Use when you need to fetch available catalogs in the account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Companies

**Slug:** `KOMMO_LIST_COMPANIES`

Action to list Kommo companies with various filter options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page of response |
| `limit` | integer | No | Number of entities to return (max 250) |
| `order` | object | No | Sorting options. Example: {'field': 'updated_at', 'direction': 'asc'} |
| `query` | string | No | Search query (searches through custom fields values) |
| `filter` | object | No | Filter parameters for companies |
| `with_params` | array | No | Additional data to include in response (leads, contacts, catalog_elements) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Contacts

**Slug:** `KOMMO_LIST_CONTACTS`

Action to list contacts in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). Use this with limit to navigate through large result sets. |
| `limit` | integer | No | Maximum number of contacts to return per page (1-250). Default is 250 if not specified. |
| `query` | string | No | Search query to filter contacts. Searches across contact custom field values (e.g., phone numbers, emails, names). Can be a string or integer. |
| `filter_ids` | array | No | Filter to return only contacts with specific IDs. Provide a list of contact IDs to retrieve. |
| `order_by_id` | string | No | Sort contacts by ID. Valid values: 'asc' (lowest ID first), 'desc' (highest ID first). |
| `with_params` | array | No | Additional embedded data to include in response. Supported values: 'leads' (include linked leads), 'catalog_elements' (include linked catalog items). Multiple values can be provided as a list. |
| `filter_names` | array | No | Filter to return only contacts with specific names. Provide a list of exact name strings to match. |
| `filter_created_at` | integer | No | Filter to return only contacts created at or after this Unix timestamp. Used to find contacts created from a specific time onwards. |
| `filter_created_by` | array | No | Filter to return only contacts created by specific users. Provide a list of user IDs. |
| `filter_updated_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_updated_by` | array | No | Filter to return only contacts last updated by specific users. Provide a list of user IDs. |
| `order_by_updated_at` | string | No | Sort contacts by last update timestamp. Valid values: 'asc' (oldest first), 'desc' (newest first). |
| `filter_closest_task_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_responsible_user_ids` | array | No | Filter to return only contacts assigned to specific responsible users. Provide a list of user IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Conversations

**Slug:** `KOMMO_LIST_CONVERSATIONS`

Tool to get a list of conversations from Kommo CRM. Use when you need to retrieve conversations with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). Use this with limit to navigate through large result sets. |
| `limit` | integer | No | Maximum number of conversations to return per page (1-250). Default is 250 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Custom Fields

**Slug:** `KOMMO_LIST_CUSTOM_FIELDS`

Action to list custom fields in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_type` | string | Yes | The type of entity to fetch custom fields for. Valid values: 'leads', 'contacts', 'companies', 'catalogs' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Entity Files

**Slug:** `KOMMO_LIST_ENTITY_FILES`

Tool to retrieve a list of files attached to an entity in Kommo CRM. Use when you need to see all files (documents, images, PDFs, etc.) that have been uploaded to a specific lead, contact, or company.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | integer | Yes | The numeric identifier for the specific entity whose files you want to retrieve. |
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | The entity type to get files for. Valid values: 'leads', 'contacts', or 'companies'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Entity Links

**Slug:** `KOMMO_LIST_ENTITY_LINKS`

Tool to get a list of entities linked to a specific entity in Kommo. Use when you need to retrieve contacts, companies, or leads linked to another entity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | integer | Yes | The numeric ID of the specific entity to get links for |
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | Type of entity to get links for. Must be one of: leads, contacts, or companies |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Entity Notes

**Slug:** `KOMMO_LIST_ENTITY_NOTES`

Tool to get a list of all notes for an entity type (leads, contacts, or companies) in Kommo CRM. Use when you need to retrieve notes across all entities of a specific type, not just for a single entity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). Use with limit to navigate through large result sets. |
| `limit` | integer | No | Maximum number of notes to return per page (1-250). Default is 250 if not specified. |
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | Type of entity to get notes for. Must be one of: leads, contacts, or companies |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Entity Tags

**Slug:** `KOMMO_LIST_ENTITY_TAGS`

Tool to get a list of tags for an entity type (leads, contacts, or companies). Use when you need to retrieve available tags for a specific entity type in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | The type of entity to fetch tags for. Valid values: 'leads', 'contacts', or 'companies' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Events

**Slug:** `KOMMO_LIST_EVENTS`

Tool to get a list of events from Kommo CRM with filtering options. Use when you need to retrieve events history, track changes to entities (leads, contacts, companies), or monitor specific event types like status changes, field updates, or assignment changes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). Use this with limit to navigate through large result sets. |
| `limit` | integer | No | Maximum number of events to return per page (1-250). Default is 250 if not specified. |
| `filter_type` | string | No | Filter by event type (e.g., 'lead_status_changed', 'entity_responsible_changed', 'custom_field_value_changed'). Limits results to specific event types. |
| `filter_entity` | string | No | Filter by entity type. Valid values: 'lead', 'contact', 'company'. Limits results to events for specific entity types. |
| `filter_value_after` | object | No | Filter model for value_after parameter with nested filtering options. |
| `filter_value_before` | object | No | Filter model for value_after parameter with nested filtering options. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Event Types

**Slug:** `KOMMO_LIST_EVENT_TYPES`

Tool to get a list of all available event types in Kommo CRM. Use when you need to see what event types can be used for filtering events or configuring webhooks.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Field Groups

**Slug:** `KOMMO_LIST_FIELD_GROUPS`

Tool to get a list of custom field groups for an entity type in Kommo CRM. Use when you need to retrieve field group information to organize custom fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | The entity type for which to list field groups. Valid values: leads, contacts, companies |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Files

**Slug:** `KOMMO_LIST_FILES`

Tool to retrieve a list of files from Kommo Drive. Use when you need to search, filter, or browse files stored in the Kommo CRM system. Supports filtering by name, extension, size, date, creator, and other criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter_date` | object | No | Filter for date ranges on files. |
| `filter_name` | string | No | Filter files by exact name match. |
| `filter_size` | object | No | Filter for file size range. |
| `filter_term` | string | No | Search term - a substring to search for in file names or names of related entities. |
| `filter_uuid` | array | No | Array of file UUIDs to filter by. Returns only files with matching UUIDs. |
| `filter_deleted` | string | No | Include deleted files when passed. Should be a JSON string (e.g., 'true' or 'false'). |
| `filter_source_id` | integer | No | Filter by source ID - the ID of the source the file originated from. |
| `filter_created_by` | array | No | Filter by creator IDs. Special values: -1 (client), 0 (robot), or positive integers for user IDs. |
| `filter_extensions` | array | No | Filter files by file extensions (e.g., 'pdf', 'jpg', 'docx'). Returns only files with matching extensions. |
| `filter_updated_by` | array | No | Filter by last modifier IDs. Returns only files last updated by specified users. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Incoming Leads

**Slug:** `KOMMO_LIST_INCOMING_LEADS`

Tool to get a list of incoming leads (unsorted) from Kommo with filtering and pagination. Use when you need to retrieve unprocessed leads that haven't been sorted into pipelines yet. Supports filtering by category (sip, mail, forms, chats), UID, and pipeline ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Use to navigate through multiple pages of results. |
| `limit` | integer | No | Number of entities to return per page (maximum 250). Controls how many incoming leads are returned in one request. |
| `filter_uid` | array | No | Filter by incoming lead UID(s). Provide single UID or array of UIDs to filter results to specific incoming leads. |
| `filter_category` | array | No | Filter by incoming lead category. Valid categories: sip (phone calls), mail (emails), forms (web forms), chats (chat messages). Can specify multiple categories. |
| `order_created_at` | string ("asc" | "desc") | No | Sort order for results. |
| `filter_pipeline_id` | integer | No | Filter by pipeline ID. Returns only incoming leads associated with the specified pipeline. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Leads

**Slug:** `KOMMO_LIST_LEADS`

Action to list leads in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `limit` | integer | No | Number of entities to return (max 250) |
| `query` | string | No | Search query (searches through filled fields of the entity) |
| `filter_ids` | array | No | Filter by lead IDs |
| `order_by_id` | string | No | Sort results by lead ID. Valid values: 'asc' (ascending, lowest ID first) or 'desc' (descending, highest ID first) |
| `with_params` | array | No | List of additional data to include in the response. Valid values: 'contacts', 'only_deleted', 'loss_reason', 'is_price_modified_by_robot', 'catalog_elements', 'source_id'. Multiple values can be included. |
| `filter_names` | array | No | Filter by lead names |
| `filter_price` | integer | No | Filter by lead price |
| `filter_status` | object | No | Model for status filters in a specific pipeline. |
| `filter_closed_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_created_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_created_by` | array | No | Filter by IDs of users who created the leads |
| `filter_updated_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_updated_by` | array | No | Filter by IDs of users who last updated the leads |
| `filter_pipeline_ids` | array | No | Filter by pipeline IDs |
| `order_by_created_at` | string | No | Sort results by creation date. Valid values: 'asc' (ascending, oldest first) or 'desc' (descending, newest first) |
| `order_by_updated_at` | string | No | Sort results by update date. Valid values: 'asc' (ascending, oldest first) or 'desc' (descending, newest first) |
| `filter_closest_task_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_responsible_user_ids` | array | No | Filter by responsible user IDs |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Lead Pipelines

**Slug:** `KOMMO_LIST_LEADS_PIPELINES`

Action to list lead pipelines in Kommo CRM.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Loss Reasons

**Slug:** `KOMMO_LIST_LOSS_REASONS`

Action to list loss reasons for leads in Kommo CRM. Use when you need to retrieve all available loss reasons that can be assigned to lost leads.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Notes By Entity

**Slug:** `KOMMO_LIST_NOTES_BY_ENTITY`

Tool to get notes for a specific entity by its ID in Kommo CRM. Use when you need to retrieve all notes associated with a lead, contact, or company.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | integer | Yes | The unique identifier of the entity to retrieve notes for |
| `entity_type` | string ("leads" | "contacts" | "companies") | Yes | Type of entity to get notes for. Must be one of: leads, contacts, or companies |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Pipeline Stages

**Slug:** `KOMMO_LIST_PIPELINE_STAGES`

Action to list stages of a pipeline in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pipeline_id` | integer | Yes | Pipeline ID |
| `with_description` | boolean | No | Whether to include stage description in the response |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo User Roles

**Slug:** `KOMMO_LIST_ROLES`

Tool to get a list of user roles in Kommo CRM. Use when you need to retrieve available user roles and their permissions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Lead Sources

**Slug:** `KOMMO_LIST_SOURCES`

Tool to get a list of lead sources in Kommo CRM. Use when you need to retrieve all available lead sources that can be assigned to leads.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Tasks

**Slug:** `KOMMO_LIST_TASKS`

Action to list tasks in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number |
| `limit` | integer | No | Number of entities to return (max 250) |
| `filter_ids` | array | No | Filter by task IDs |
| `order_by_id` | string | No | Sort by id (asc/desc) |
| `filter_entity_ids` | array | No | Filter by entity IDs the task is linked to |
| `filter_task_types` | array | No | Filter by task type IDs |
| `filter_updated_at` | object | No | Model for date range filters in Unix timestamp format. |
| `filter_entity_type` | string | No | Filter by entity type the task is linked to |
| `filter_is_completed` | integer | No | Filter by task status (1 - completed, 0 - open) |
| `order_by_created_at` | string | No | Sort by created_at (asc/desc) |
| `order_by_complete_till` | string | No | Sort by complete_till (asc/desc) |
| `filter_responsible_user_ids` | array | No | Filter by task responsible user IDs |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Templates

**Slug:** `KOMMO_LIST_TEMPLATES`

Tool to get a list of message templates in Kommo CRM. Use when you need to retrieve chat response templates that can be utilized in cards and bots.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). Use with limit to navigate through result sets. |
| `limit` | integer | No | Maximum number of templates to return per page (1-250). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Users

**Slug:** `KOMMO_LIST_USERS`

Tool to get a list of users from Kommo CRM with pagination support. Use when you need to retrieve all users in the account or paginate through the users list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). Use this with limit to navigate through large result sets. |
| `limit` | integer | No | Maximum number of users to return per page (1-250). Default is 250 if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Webhooks

**Slug:** `KOMMO_LIST_WEBHOOKS`

Tool to get a list of registered webhooks for the Kommo account. Use when you need to view all webhook configurations and their settings.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Website Buttons

**Slug:** `KOMMO_LIST_WEBSITE_BUTTONS`

Tool to get a list of website chat button (CRM Plugin) objects from Kommo. Use when you need to retrieve all configured website chat buttons in the account. Supports pagination for large result sets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results. |
| `limit` | integer | No | Number of entities to return per page (max 250). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Kommo Widgets

**Slug:** `KOMMO_LIST_WIDGETS`

Tool to get a list of installed widgets in Kommo. Use when you need to see which widgets are installed and their current status in the account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Kommo Company

**Slug:** `KOMMO_UPDATE_COMPANY`

Action to update a single company in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Company name |
| `company_id` | integer | Yes | ID of the company to update |
| `created_at` | integer | No | Company creation date (Unix Timestamp) |
| `created_by` | integer | No | ID of the user who created the company |
| `request_id` | string | No | This field will be returned unchanged in the response |
| `updated_at` | integer | No | Company update date (Unix Timestamp) |
| `updated_by` | integer | No | ID of the user who last updated the company |
| `tags_to_add` | array | No | Array of tags to add. Provide either tag name or ID |
| `responsible_user_id` | integer | No | Company responsible user ID |
| `custom_fields_values` | array | No | An array of the current company custom fields' values |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Kommo Contact

**Slug:** `KOMMO_UPDATE_CONTACT`

Action to update contact information in Kommo CRM by contact ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | Unique identifier of the contact to update |
| `name` | string | No | Contact full name |
| `last_name` | string | No | Contact last name |
| `first_name` | string | No | Contact first name |
| `request_id` | string | No | Custom identifier that will be returned unchanged in the response for tracking purposes |
| `responsible_user_id` | integer | No | ID of the user responsible for this contact |
| `custom_fields_values` | array | No | Array of custom field values to update for the contact |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Kommo Lead

**Slug:** `KOMMO_UPDATE_LEAD`

Action to update an existing lead in Kommo CRM. Allows modifying lead properties including name, price, pipeline stage, responsible user, tags, and custom fields. Requires the lead ID to be specified.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the lead to update |
| `name` | string | No | Lead name or title |
| `price` | integer | No | Lead sale amount or budget value in the account's currency |
| `closed_at` | integer | No | Lead closure date (Unix Timestamp) |
| `status_id` | integer | No | Pipeline stage ID to move the lead to. Use LIST_PIPELINE_STAGES action to get valid stage IDs |
| `created_at` | integer | No | Lead creation date (Unix Timestamp) |
| `created_by` | integer | No | The ID of the user who originally created the lead. When passing 0, indicates creation by automation robot. Note: This field is typically set at creation and rarely updated |
| `request_id` | string | No | Field that will be returned unchanged in the response |
| `updated_at` | integer | No | Lead update date (Unix Timestamp) |
| `updated_by` | integer | No | The ID of the user updating the lead. When passing 0, lead will be updated by robot |
| `pipeline_id` | integer | No | Pipeline ID to move the lead to. Use LIST_LEADS_PIPELINES action to get valid pipeline IDs |
| `tags_to_add` | array | No | Array of tags to add to the lead. Each object should contain either 'name' (string) or 'id' (integer). Example: [{'name': 'important'}, {'id': 123}] |
| `loss_reason_id` | integer | No | Lead loss reason ID |
| `tags_to_delete` | array | No | Array of tags to remove from the lead. Each object should contain either 'name' (string) or 'id' (integer). Example: [{'name': 'old-tag'}, {'id': 456}] |
| `responsible_user_id` | integer | No | Lead responsible user ID |
| `custom_fields_values` | array | No | Array of custom field values to update. Each object should contain 'field_id' or 'field_code' and 'values' array. Use LIST_CUSTOM_FIELDS action to get available custom fields |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Kommo Task

**Slug:** `KOMMO_UPDATE_TASK`

Action to update a task in Kommo CRM.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The unique identifier of the task to update |
| `text` | string | No | Task description |
| `result` | object | No | Model for task result data. |
| `duration` | integer | No | Task duration in seconds |
| `entity_id` | integer | No | ID of the entity the task is linked to |
| `entity_type` | string | No | Type of the entity the task is linked to (e.g., 'leads', 'contacts', 'companies') |
| `is_completed` | boolean | No | Defines whether the task is completed |
| `task_type_id` | integer | No | Task type ID. Standard types: 1 = Follow-up, 2 = Meeting |
| `complete_till` | integer | No | Task deadline date in Unix Timestamp format |
| `responsible_user_id` | integer | No | ID of the user responsible for the task. If not specified, the current user remains responsible |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |