Skip to main content
POST
Creates a task in the CRM. It belongs to the records in targetIds, not to a project or a Space. The people in assigneeIds are told as in the app.
Scope crm:write. The token owner needs the right to create tasks and to read every record the task is on.

Request body

string
required
Up to 300 characters.
string
Plain text, up to 20,000 characters.
string | null
A calendar day as YYYY-MM-DD.
string
default:"TODO"
TODO, IN_PROGRESS or DONE.
array
default:"[]"
People, at most 50.
array
required
The records the task is on, 1 to 20.
string
An id you choose (8 to 64 letters, digits, _ or -). A repeated call with the same id returns the task it already made.

Response

The created task, with status 201.
Last modified on November 13, 2026