Create a task
Create a task for a client in AroFlo.
MCP tool aroflo_write → create_task
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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "aroflo_write",
"arguments": {
"operation": "create_task",
"arguments": {
"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
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"task_id": "task_8814",
"job_number": "J1187",
"status": "Not Started",
"client": "Harbour Café",
"assigned_to": "Dana Pike"
},
"isError": false
}