Kommo

Create leads and manage your messenger-based sales pipeline in Kommo.

CRM and salesAPI key8 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (8)
create_lead
create_contact
custom_api_call
find_company
find_contact
find_lead
update_contact
update_lead
Details

Connect

Auth type: API key (secret_text). Paste the API key (or token) from the provider's settings into the connect dialog. It is encrypted at rest and only decrypted on the server when an action runs.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("kommo", "create_lead", {
    "name": "<lead name>",
    "pipelineId": "<pipelineId>",
    "statusId": "<statusId>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Kommo answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "kommo-create-lead",
  name: "Kommo: Create New Lead",
  description: "Calls Kommo when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("kommo", {
      "action": "create_lead",
      "name": "<lead name>",
      "pipelineId": "<pipelineId>",
      "statusId": "<statusId>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/kommo/create_lead" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"name":"<lead name>","pipelineId":"<pipelineId>","statusId":"<statusId>"}}'

Actions

create_leadin catalog

Create New Lead. Creates a new lead.

Input	Type	Description
`name`required	text	Lead Name
`price`optional	number	Price
`pipelineId`required	id (picked from your account)	Pipeline
`statusId`required	id (picked from your account)	Status
`responsible_user_id`optional	id (picked from your account)	Unique identified of a responsible user
`loss_reason_id`optional	id (picked from your account)	Loss Reason
`tags_to_add`optional	array	List of tags to add.

create_contact

Create New Contact. Add a new contact.

Input	Type	Description
`name`required	text	Full Name
`first_name`optional	text	First Name
`last_name`optional	text	Last Name
`email`optional	text	Email
`phone`optional	text	Phone
`responsible_user_id`optional	id (picked from your account)	Unique identified of a responsible user
`tags_to_add`optional	array	Tags to Add

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

Input	Type	Description
`url`required	object (depends on other props)	url
`method`required	one of "GET" \| "POST" \| "PATCH" \| "PUT" \| "DELETE" \| "HEAD"	Method
`headers`required	object	Authorization headers are injected automatically from your connection.
`queryParams`required	object	Query Parameters
`body_type`optional	one of "none" \| "json" \| "form_data" \| "raw"	Body Type
`body`optional	object (depends on other props)	Body
`response_is_binary`optional	boolean	Enable for files like PDFs, images, etc.
`failsafe`optional	boolean	No Error on Failure
`timeout`optional	number	Timeout (in seconds)
`followRedirects`optional	boolean	Follow redirects

find_company

Find Company. Find an existing company.

Input	Type	Description
`query`required	text	Search query (Searches through the filled fields of the company).

find_contact

Find Contact. Finds an existing contact.

Input	Type	Description
`query`required	text	Search query (Searches through the filled fields of the contact).

find_lead

Find Lead. Finds an existing lead.

Input	Type	Description
`query`required	text	Search query (Searches through the filled fields of the lead).

update_contact

Update Contact. Updates an existing contact.

Input	Type	Description
`contactId`optional	id (picked from your account)	Contact
`name`optional	text	Full Name
`first_name`optional	text	First Name
`last_name`optional	text	Last Name
`email`optional	text	Email
`phone`optional	text	Phone
`responsible_user_id`optional	id (picked from your account)	Unique identified of a responsible user
`tags_to_add`optional	array	List of tag names or IDs to add.
`tags_to_delete`optional	array	List of tag names or IDs to remove.

update_lead

Update Lead. Update existing lead info.

Input	Type	Description
`leadId`required	id (picked from your account)	Lead
`name`optional	text	Name
`price`optional	number	Price
`pipelineId`optional	id (picked from your account)	Pipeline
`statusId`optional	id (picked from your account)	Status
`responsible_user_id`optional	id (picked from your account)	Unique identified of a responsible user
`loss_reason_id`optional	id (picked from your account)	Loss Reason
`tags_to_add`optional	array	Tags to Add
`tags_to_delete`optional	array	Tags to Delete

Details

Id: kommo
Category: CRM and sales
Tags: crm, sales, messenger, leads
Package: @activepieces/piece-kommo@0.1.4
Tier: Community