Create a task
Add a task to a lead with a deadline, a responsible user and a comment.
MCP tool kommo_write → create_task
write Confirm
Creates the task as Chat → Task → Set does on the lead card and returns its task_id. Kommo reminds the responsible user about the task, so it reaches a colleague. An unknown task_type fails and lists the types of the account. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| lead_id integer required | integer | Lead ID from list_leads or get_lead. |
| task_type string | string | Follow-up or Meeting, or the name of a custom type an admin added. Default Follow-up. |
| deadline string required | string | ISO 8601 date and time. |
| responsible_user_id integer | integer | User the task is assigned to. Default is the lead owner. |
| comment string | string | Task comment. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kommo_write",
"arguments": {
"operation": "create_task",
"arguments": {
"lead_id": 24518301,
"task_type": "Follow-up",
"deadline": "2026-10-22T10:00:00+02:00",
"responsible_user_id": 9102334,
"comment": "Proposal sent 12 Oct, no reply. Ask if the quote needs changes."
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"task_id": 5530194,
"lead_id": 24518301,
"type": "Follow-up",
"deadline": "2026-10-22T10:00:00+02:00",
"responsible": {
"user_id": 9102334,
"name": "Anna Berg"
},
"comment": "Proposal sent 12 Oct, no reply. Ask if the quote needs changes."
},
"isError": false
}