Skip to main content
POST
Create Task

Request

At least one parent link is required. A task must reference contact_id, deal_id, or event_id. Orphan tasks are rejected with 400.

Body Parameters

string
required
Task title
string
Task description
string
default:"open"
Status (open, in_progress, completed)
string
Priority level (low, medium, high)
string
Task type
string
Due date (ISO 8601 or YYYY-MM-DD)
string
Assignee user ID
string
UUID of linked contact. Must belong to your workspace.
string
Human name — fuzzy-matched within your workspace and resolved to contact_id. On ambiguous matches, returns 400 ambiguous_reference with candidate UUIDs.
string
Human name — fuzzy Company match.
string
UUID of linked deal.
string
UUID of linked event.
string
Optional ISO 8601 timestamp. Honored verbatim if within the last 5 years and not more than 24 h in the future; otherwise the server now() is used. Never null.

Headers

Response

object
Created task with id, title, status, priority, due_date, assigned_to_user_id, contact_id, deal_id, event_id, created_date.

Errors

Orphan-task rejection example