Skip to main content
POST
/
v1
/
tasks
Task
curl --request POST \
  --url https://api.example.com/v1/tasks

Documentation Index

Fetch the complete documentation index at: https://docs.reachedapp.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Create a Task

Creates a new task. Optionally link it to a lead or assign it to a specific user.

​
Request

POST /v1/tasks

​
Body Parameters

ParameterTypeRequiredDescription
titlestringYesTask title
descriptionstringNoTask description
notesstringNoAdditional notes
lead_iduuidNoLink task to a lead
user_iduuidNoAssign task to a specific user
due_datestringNoDue date (YYYY-MM-DD)
due_timestringNoDue time (HH:MM)
prioritystringNoPriority: low, medium, or high (default: medium)

​
Example

curl -X POST \
  "https://YOUR_PROJECT.supabase.co/functions/v1/api-gateway/v1/tasks" \
  -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Follow up with John Doe",
    "lead_id": "a1b2c3d4-...",
    "due_date": "2026-03-25",
    "priority": "high"
  }'

​
Response

{
  "data": {
    "id": "task-uuid-1",
    "title": "Follow up with John Doe",
    "lead_id": "a1b2c3d4-...",
    "status": "pending",
    "priority": "high",
    "due_date": "2026-03-25",
    "created_at": "2026-03-21T10:00:00.000Z"
  }
}