Crm

Kommo

Learn how to use Kommo with Composio

Overview

SLUG: KOMMO

Description

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

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
subdomain
stringRequired

Connecting to Kommo

Create an auth config

Use the dashboard to create an auth config for the Kommo toolkit. This allows you to connect multiple Kommo accounts to Composio for agents to use.

1

Select App

Navigate to Kommo.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Kommo Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4kommo_auth_config_id = "ac_YOUR_KOMMO_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11    connection_request = composio.connected_accounts.initiate(
12        user_id=user_id,
13        auth_config_id=auth_config_id,
14    )
15
16    print(
17        f"Visit this URL to authenticate Kommo: {connection_request.redirect_url}"
18    )
19
20    # This will wait for the auth flow to be completed
21    connection_request.wait_for_connection(timeout=15)
22    return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, kommo_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Kommo toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Create Kommo Companies

Description

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

Action Parameters

created_at
created_by
custom_fields_values
name
stringRequired
request_id
responsible_user_id
tags_to_add
updated_at
updated_by

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Kommo Contact

Description

Action to create one or more contacts in Kommo CRM.

Action Parameters

contacts
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Kommo Lead

Description

Action to create one or more leads in Kommo CRM.

Action Parameters

closed_at
created_at
created_by
custom_fields_values
loss_reason_id
name
stringRequired
pipeline_id
price
responsible_user_id
status_id
tags_to_add
tags_to_delete
updated_at
updated_by

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Kommo Tasks

Description

Action to create a task in Kommo CRM.

Action Parameters

complete_till
created_at
created_by
duration
entity_id
entity_type
responsible_user_id
task_type_id
text
stringRequired
updated_at
updated_by

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Companies

Description

Action to list Kommo companies with various filter options.

Action Parameters

filter
limit
order
page
query
with_params

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Contacts

Description

Action to list contacts in Kommo CRM.

Action Parameters

filter_closest_task_at
filter_created_at
filter_created_by
filter_ids
filter_names
filter_responsible_user_ids
filter_updated_at
filter_updated_by
limit
order_by_id
order_by_updated_at
page
query
with_params

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Custom Fields

Description

Action to list custom fields in Kommo CRM.

Action Parameters

entity_type
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Leads

Description

Action to list leads in Kommo CRM.

Action Parameters

filter_closed_at
filter_closest_task_at
filter_created_at
filter_created_by
filter_ids
filter_names
filter_pipeline_ids
filter_price
filter_responsible_user_ids
filter_status
filter_updated_at
filter_updated_by
limit
order_by_created_at
order_by_id
order_by_updated_at
page
query
with_params

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Lead Pipelines

Description

Action to list lead pipelines in Kommo CRM.

Action Parameters

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Pipeline Stages

Description

Action to list stages of a pipeline in Kommo CRM.

Action Parameters

pipeline_id
integerRequired
with_description

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Kommo Tasks

Description

Action to list tasks in Kommo CRM.

Action Parameters

filter_entity_ids
filter_entity_type
filter_ids
filter_is_completed
filter_responsible_user_ids
filter_task_types
filter_updated_at
limit
order_by_complete_till
order_by_created_at
order_by_id
page

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Kommo Company

Description

Action to update a single company in Kommo CRM.

Action Parameters

company_id
integerRequired
created_at
created_by
custom_fields_values
name
request_id
responsible_user_id
tags_to_add
updated_at
updated_by

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Kommo Contact

Description

Action to update contacts in Kommo CRM.

Action Parameters

created_at
created_by
custom_fields_values
first_name
id
integerRequired
last_name
name
request_id
responsible_user_id
updated_at
updated_by

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Kommo Lead

Description

Action to update a lead in Kommo CRM.

Action Parameters

closed_at
created_at
created_by
custom_fields_values
id
integerRequired
loss_reason_id
name
pipeline_id
price
request_id
responsible_user_id
status_id
tags_to_add
tags_to_delete
updated_at
updated_by

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Kommo Task

Description

Action to update a task in Kommo CRM.

Action Parameters

complete_till
duration
entity_id
entity_type
id
integerRequired
is_completed
responsible_user_id
result
task_type_id
text

Action Response

data
objectRequired
error
successful
booleanRequired