Create a task
Create a task for a client in AroFlo.
POST https://cotlet.dev/api/v1/aroflo/clients/{client_id}/tasks
write Confirm
Creates the task as Not Started and returns its task_id and job number. Assign To makes a person responsible for the task but does not book them; use schedule_task for the person who does the work. A task type or priority your site does not have fails with an error that lists the valid ones. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| client_id string required | string | Client ID from list_clients. |
| task_name string required | string | Name of the task. |
| task_type string required | string | A Task Type that exists on your site. |
| description string | string | What needs doing. |
| priority string | string | A Priority that exists on your site. |
| due_date string | string | Due date, YYYY-MM-DD. |
| location string | string | A location of the client from list_clients. |
| assign_to string | string | Name of the user the task is assigned to. |
| reported_by string | string | Contact who reported the job. |
Request
curl -X POST https://cotlet.dev/api/v1/aroflo/clients/client_311/tasks \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task_name":"Aircon not cooling","task_type":"Service Call","description":"Café split system blowing warm air since Monday.","priority":"High","due_date":"2026-10-30","assign_to":"Dana Pike"}'result = client.call("aroflo", "create_task", {"client_id":"client_311","task_name":"Aircon not cooling","task_type":"Service Call","description":"Café split system blowing warm air since Monday.","priority":"High","due_date":"2026-10-30","assign_to":"Dana Pike"})const result = await cotlet.call('aroflo', 'create_task', {"client_id":"client_311","task_name":"Aircon not cooling","task_type":"Service Call","description":"Café split system blowing warm air since Monday.","priority":"High","due_date":"2026-10-30","assign_to":"Dana Pike"});cotlet call aroflo create_task --data '{"client_id":"client_311","task_name":"Aircon not cooling","task_type":"Service Call","description":"Café split system blowing warm air since Monday.","priority":"High","due_date":"2026-10-30","assign_to":"Dana Pike"}'Example response
{
"task_id": "task_8814",
"job_number": "J1187",
"status": "Not Started",
"client": "Harbour Café",
"assigned_to": "Dana Pike"
}