> ## Documentation Index
> Fetch the complete documentation index at: https://visaflo.ca/knowledge-base/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a task

> Create a task linked to a VisaFlo lead, client, or case.

`POST https://api.visaflo.app/api/public/task/create`

| Field                                        | Required | Values                                                                     |
| -------------------------------------------- | -------- | -------------------------------------------------------------------------- |
| `title`                                      | Yes      | Non-empty task title.                                                      |
| `priority`                                   | Yes      | `low`, `medium`, `high`, or `urgent`.                                      |
| `status`                                     | Yes      | `open`, `in_progress`, or `completed`.                                     |
| `entity`                                     | Yes      | Object with a `type` of `case`, `client`, or `lead`, plus the record `id`. |
| `description`, `dueDate`, `reminderSettings` | No       | `dueDate` uses `YYYY-MM-DD`.                                               |

```json theme={null}
{
  "title": "Review new intake",
  "priority": "high",
  "status": "open",
  "entity": { "type": "lead", "id": "VFLO_LEAD_ID" }
}
```

Returns `201` with the created task. VisaFlo inherits assignees from the linked record.