get_contact
Get Contact
Retrieve a single contact by its ID. Returns full contact details including name, linked leads, tags, and custom fields.
get_contact
Retrieve a single contact by its ID. Returns full contact details including name, linked leads, tags, and custom fields.
update_contact
Update an existing contact. Change name, responsible user, tags, or custom field values (phone, email, etc.).
add_note
Add a note to a lead, contact, or company. Supports various note types including plain text, call records, SMS, service messages, and geolocation.
create_contact
Create a new contact in Kommo. Set the contact name, assign a responsible user, add tags, set custom field values (e.g., phone, email), and optionally link to a company.
list_contacts
Search and list contacts in Kommo. Supports filtering by search query, responsible user, and contact IDs. Returns contacts with their linked leads, tags, and custom fields.
create_task
Create a new task in Kommo. Tasks can be linked to leads, contacts, or companies. Set the task description, deadline, type (follow-up or meeting), duration, and responsible user.
get_company
Retrieve a single company by its ID. Returns full company details including name, linked contacts, tags, and custom fields.
list_notes
List notes attached to a lead, contact, or company. Returns notes with their type, content, and metadata.
list_custom_fields
List custom fields for leads, contacts, or companies. Returns field definitions including type, available options for select fields, and field IDs needed for setting custom field values on entities.
list_pipelines
List all sales pipelines and their stages. Each pipeline contains ordered stages that represent steps in the sales process. Use this to discover available pipelines and stage IDs for creating or moving leads.
update_lead
Update an existing lead. Change its name, price, pipeline stage, responsible user, tags, custom fields, or loss reason. Use this to move leads between pipeline stages or mark them as won/lost.
list_leads
Search and list sales leads in Kommo. Supports filtering by search query, pipeline, responsible user, and lead IDs. Returns leads with their pipeline stage, price, tags, and custom fields.
manage_tags
List existing tags or create new tags for leads, contacts, or companies. Tags are entity-type specific. Use **action** "list" to see all tags, or "create" to add new ones.
get_lead
Retrieve a single lead by its ID. Returns full lead details including pipeline stage, price, contacts, tags, custom fields, and loss reason.
list_companies
Search and list companies in Kommo. Supports filtering by search query, responsible user, and company IDs. Returns companies with tags and custom fields.
get_account
Get Kommo account information including account name, subdomain, current user, currency, and configured task types and user groups.
create_company
Create a new company in Kommo. Set the company name, assign a responsible user, add tags, and set custom field values.
create_lead
Create a new sales lead in Kommo. Optionally link it to a pipeline/stage, assign a responsible user, set a price, add tags, and set custom field values. Can also create associated contacts and companies in a single operation using the complex mode.
list_users
List account users or get a specific user by ID. Returns user details including name, email, role, and admin status. Use this to find user IDs for assigning leads, contacts, or tasks.
update_task
Update an existing task. Change its text, deadline, responsible user, or mark it as completed with an optional result message.
manage_entity_links
List, create, or remove links between entities. Link leads to contacts, contacts to companies, leads to catalog items, etc. Use **action** "list" to see existing links, "link" to create new links, or "unlink" to remove them.
list_tasks
Search and list tasks in Kommo. Filter by completion status, responsible user, linked entity, or task IDs. Returns tasks with their deadlines, linked entities, and completion status.
update_company
Update an existing company. Change name, responsible user, tags, or custom field values.
list_events
List events (audit log) from the Kommo account. Filter by entity type, entity ID, event types, or time range. Tracks all changes across leads, contacts, companies, and more.
Manage sales leads, contacts, companies, and pipelines in a messenger-based CRM. Create, read, update, and delete leads with pipeline stage tracking, loss reasons, and duplicate control. Manage contacts and companies with custom fields, tags, and entity linking. Create and organize sales pipelines with customizable stages. Handle tasks with deadlines and assignments linked to CRM entities. Send and receive messages through connected chat channels (WhatsApp, Telegram, etc.), manage conversation history, and track delivery status. Process incoming/unsorted leads from web forms and other sources — accept, decline, or link them. Upload and attach files to entities. Manage users, roles, and permissions. Create message templates including WhatsApp templates. Launch and control Salesbot automations for automated chat responses. Add AI knowledge sources and import products for AI features. Log calls and handle VoIP notifications. Subscribe to webhooks for real-time notifications on lead, contact, company, task, customer, and conversation events.
Common questions about connecting Kommo to AI agents with Metorial.