Create task
Creates a task and assigns it to an employee.
POST https://cotlet.dev/api/v1/peoplehr/assignees/{assignee_id}/tasks
write Confirm
Creates the task from the plus icon in the Tasks area. An admin can assign it to anyone, a manager only to employees who report to them, and PeopleHR refuses someone who is leaving. Documents cannot be attached to a task. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| title string required | string | Task title. |
| assignee_id string required | string | Employee ID of the person who does the task. |
| about_employee_id string | string | Employee ID the task is in relation to, for example a new starter. |
| completion_date string | string | Completion date, YYYY-MM-DD. Optional. |
| description string | string | What to do. |
Request
curl -X POST https://cotlet.dev/api/v1/peoplehr/assignees/PW8/tasks \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"Book first 1:1","about_employee_id":"PW41","completion_date":"2026-11-23","description":"Book a 30 minute 1:1 in the first week."}'result = client.call("peoplehr", "create_task", {"title":"Book first 1:1","assignee_id":"PW8","about_employee_id":"PW41","completion_date":"2026-11-23","description":"Book a 30 minute 1:1 in the first week."})const result = await cotlet.call('peoplehr', 'create_task', {"title":"Book first 1:1","assignee_id":"PW8","about_employee_id":"PW41","completion_date":"2026-11-23","description":"Book a 30 minute 1:1 in the first week."});cotlet call peoplehr create_task --data '{"title":"Book first 1:1","assignee_id":"PW8","about_employee_id":"PW41","completion_date":"2026-11-23","description":"Book a 30 minute 1:1 in the first week."}'Example response
{
"task_id": "tsk-3301",
"title": "Book first 1:1",
"assignee": "Dana Reyes",
"about": "Ana Lopez",
"completion_date": "2026-11-23",
"status": "New"
}