Add task
Create a Vincere task with subject, type, due date and assignee.
POST https://cotlet.dev/api/v1/vincere/tasks
write Confirm
Creates a task like the Task board form. task_type is candidate, contact, project, job, job_lead or personal. Pass candidate_id or job_id to link it. The assignee is notified in Vincere. With sync_with_calendar true the task goes to your primary connected calendar, and once synced it cannot be un-synced. Cotlet has no tool to delete a task. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| subject string required | string | Short title of the task. |
| task_type enum | enum | candidate, contact, project, job, job_lead or personal. Default: personal. |
| due datetime required | datetime | Due date and time, ISO 8601. |
| assignee string | string | Team member responsible. Default: you. |
| candidate_id string | string | Link the task to this candidate. |
| job_id string | string | Link the task to this job. |
| description string | string | Longer text of the task. |
| sync_with_calendar boolean | boolean | Add the task to your connected calendar. Cannot be undone. Default: false. |
Request
curl -X POST https://cotlet.dev/api/v1/vincere/tasks \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subject":"subject","due":"2026-10-01T09:00:00Z"}'result = client.call("vincere", "add_task", {"subject":"subject","due":"2026-10-01T09:00:00Z"})const result = await cotlet.call('vincere', 'add_task', {"subject":"subject","due":"2026-10-01T09:00:00Z"});cotlet call vincere add_task --data '{"subject":"subject","due":"2026-10-01T09:00:00Z"}'Example response
{
"task_id": "T-5521",
"subject": "Send Priya the job description",
"type": "Candidate",
"due": "2026-10-23T10:00:00",
"assignee": "Dana Fox",
"calendar_synced": false
}