Accept an incoming lead
Turn an incoming chat into a lead, the Accept button in the chat.
MCP tool kommo_write → accept_incoming_lead
write Confirm
Accepts the chat as the Accept button does: the lead is created and moves to the next stage. It returns the lead_id. A Digital Pipeline trigger on that stage fires for the new lead and can message the client. Chats that match an existing lead are not linked here. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| chat_id string required | string | Chat ID from list_conversations or list_incoming_leads. |
| responsible_user_id integer | integer | Owner of the new lead. Default is you. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kommo_write",
"arguments": {
"operation": "accept_incoming_lead",
"arguments": {
"chat_id": "c8f2a6d1",
"responsible_user_id": 9102334
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"lead_id": 24519044,
"chat_id": "c8f2a6d1",
"stage": "Contacted",
"responsible": {
"user_id": 9102334,
"name": "Anna Berg"
}
},
"isError": false
}