Create task
Creates a task for a contact with a type, due date and owner.
POST https://cotlet.dev/api/v1/agile-crm/contacts/{contact_id}/tasks
write
Creates the task on the contact and returns its id. A task shows in the owner's Tasks list inside your team and is deleted in Agile CRM in one step, so the call does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| contact_id string required | string | Contact the task belongs to |
| subject string required | string | What has to be done |
| type string | string | CALL, EMAIL, FOLLOW_UP, MEETING, MILESTONE, SEND, TWEET or OTHER |
| due_date string required | string | Due date, YYYY-MM-DD |
| owner_email string | string | User the task is assigned to; you when left out |
Request
curl -X POST https://cotlet.dev/api/v1/agile-crm/contacts/contact_8c41d2/tasks \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subject":"subject","due_date":"due date"}'result = client.call("agile-crm", "create_task", {"contact_id":"contact_8c41d2","subject":"subject","due_date":"due date"})const result = await cotlet.call('agile-crm', 'create_task', {"contact_id":"contact_8c41d2","subject":"subject","due_date":"due date"});cotlet call agile-crm create_task --data '{"contact_id":"contact_8c41d2","subject":"subject","due_date":"due date"}'Example response
{
"task_id": "5733100225388544",
"contact_id": "5698320417841152",
"subject": "Send quote",
"type": "EMAIL",
"due": "2026-10-26",
"owner": "sam@example.com"
}