Sign in
Tasks

Create a task

Creates a task with a due date, optional assignee, priority, tags and an optional link to a person or company. The assignee defaults to the API key owner; priority defaults to medium. The type is inferred from the link: person, company, or general when unlinked.

post/api/v1/tasks

Request body

contentstring required

What needs to be done

dueDatestring required

Due date (YYYY-MM-DD)

ownerIdstring uuid

User ID of the assignee. Defaults to the API key owner when omitted

personIdstring uuid

Link the task to this person

companyIdstring uuid

Link the task to this company

priority'high' | 'medium' | 'low'

Priority. Defaults to medium when omitted

tagIdsstring[]

Tag IDs to attach (unknown IDs are ignored)

Example request

{
  "content": "Call the candidate",
  "dueDate": "2026-08-15",
  "priority": "medium"
}

Response

Task created

status'ok' required

Changes

Changed in 1 of the 6 revisions of this API.1