Get current Kommo account information (name, id, subdomain, users count, optional embedded data). Use with=drive_url,amojo_id,version,datetime_settings to include extras.

List leads with pagination, filters and optional embedded entities. Max 250 per page. Rate limit 7 req/s.

Convenience full-text search for leads by name/query. Prefer kommo_leads_list for advanced filters.

Move a lead to another pipeline stage. Set loss_reason_id when moving to a lost status.

Get a single lead by its ID, optionally embedding related entities.

Create one or more leads. Pass an array of lead objects. Returns created leads with IDs.

Update one or more leads. Each object must include id. For a single lead you may also use id + fields.

Update a single lead by ID (PATCH /leads/{id}).

Create leads with contacts and companies in one request (duplicate control supported). POST /api/v4/leads/complex

List all lead loss reasons configured in the account.

Get a loss reason by ID.

List unsorted/incoming leads in the inbox.

Get an incoming lead by UID.

Get summary counts for incoming leads.

Add incoming leads of type sip/call. POST /leads/unsorted/sip

Add incoming leads from forms. POST /leads/unsorted/forms

Accept unsorted leads into the pipeline.

Decline/decline unsorted leads.

Link an incoming lead to an existing lead.

List contacts with pagination and filters. Use query to search by name, phone, or email.

Get a single contact by ID.

Create one or more contacts. For phone/email use custom_fields_values with field_code PHONE or EMAIL.

Update one or more contacts. Each object must include id.

Update a single contact by ID.

List companies with pagination and filters.

Get a single company by ID.

Create one or more companies.

Update one or more companies. Each object must include id.

Update a single company by ID.

List all lead pipelines (and their stages when embedded).

Get a pipeline by ID including stages.

Create one or more pipelines (optionally with stages).

Edit a pipeline by ID.

Delete a pipeline by ID. Destructive — cannot be undone.

List stages for a pipeline.

Get a stage by pipeline ID and stage ID.

Add one or more stages to a pipeline.

Edit a stage in a pipeline.

Delete a stage from a pipeline. Destructive.

List tasks with pagination and filters.

Get a single task by ID.

Create one or more tasks. Typical fields: text, complete_till (unix), entity_id, entity_type, responsible_user_id, task_type_id.

Update one or more tasks. Each object must include id. Set is_completed=true to complete.

Update a single task by ID.

List notes for an entity type (leads|contacts|companies|customers).

List notes for a specific entity ID.

Get a note by entity type and note ID.

Create notes. Each note needs entity_id, note_type (e.g. common), and params (e.g. { text }).

Update multiple notes. Each object needs id.

Update a single note by ID.

Pin a note on an entity.

Unpin a note on an entity.

List tags for leads, contacts, companies, or customers.

Create tags for an entity type. For leads, color can be set.

Add/update tags on entities. Pass array of { id, tags: [{ id }|{ name }] } or use tags_to_add / tags_to_delete.

Update tags on a single entity by ID.

List custom fields for an entity type.

Get a custom field by ID for an entity type.

Create custom fields on an entity type.

Update multiple custom fields.

Update one custom field by ID.

Delete a custom field. Destructive.

List custom fields for a catalog (list).

Get a catalog custom field by ID.

Add custom fields to a catalog.

Update catalog custom fields.

Update a single catalog custom field.

List custom field groups for an entity type.

Get a field group by ID.

Create field groups for an entity type.

Edit a field group by ID.

Delete a field group. Destructive.

List catalogs (lists) in the account (products, etc.).

Get a catalog by ID.

Create one or more catalogs.

Update multiple catalogs.

Update a catalog by ID.

List elements (e.g. products) in a catalog.

Get a catalog element by ID.

Add elements to a catalog.

Update multiple catalog elements.

Update one catalog element by ID.

List users in the account.

Get a user by ID.

Add users to the account.

Activate users in bulk.

Deactivate users in bulk.

List user roles.

Get a role by ID.

Create user roles.

Edit user roles.

Delete a role by ID. Destructive.

List account events (timeline activity) with filters.

Get a single event by ID.

Get all available event types.

List entities linked to a lead, contact, company, or customer.

Link entities to a parent. Each link needs to_entity_id and to_entity_type; catalog links may need metadata.

Unlink entities from a parent.

List webhooks configured in the account.

Create a webhook. Provide destination URL and list of events (e.g. add_lead, update_contact).