Create a lead
Add a lead to a pipeline stage, optionally with a contact.
MCP tool kommo_write → create_lead
write Confirm
Creates the lead as the New lead button does and returns its lead_id and the card URL. A Digital Pipeline trigger on the stage fires for the new lead, so it can start a Salesbot or send an email. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| name string required | string | Lead name. |
| pipeline_id integer required | integer | Pipeline ID from list_pipelines. |
| stage_id integer | integer | Stage ID from list_pipelines. Default is the first stage. |
| sale integer | integer | Sale amount in the account currency. |
| responsible_user_id integer | integer | Owner of the lead. Default is you. |
| tags array | array | Tag names to add. |
| contact_name string | string | Creates and links a contact with this name. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kommo_write",
"arguments": {
"operation": "create_lead",
"arguments": {
"name": "Dental clinic website",
"pipeline_id": 8210123,
"stage_id": 71000002,
"sale": 4800,
"responsible_user_id": 9102334,
"tags": [
"website"
],
"contact_name": "Tom Becker"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"lead_id": 24519010,
"name": "Dental clinic website",
"pipeline_id": 8210123,
"stage": "Contacted",
"url": "https://yourcompany.kommo.com/leads/detail/24519010",
"created_at": "2026-10-20T09:15:00+02:00"
},
"isError": false
}