Create a task
Add a task to a lead with a deadline, a responsible user and a comment.
POST https://cotlet.dev/api/v1/kommo/leads/{lead_id}/tasks
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. |
Request
curl -X POST https://cotlet.dev/api/v1/kommo/leads/24518301/tasks \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"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."}'result = client.call("kommo", "create_task", {"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."})const result = await cotlet.call('kommo', 'create_task', {"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."});cotlet call kommo create_task --data '{"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
{
"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."
}