Skip to main content

Tasks

Actionable to-dos, optionally attached to a record.

📄️Create a task

Create a task. `title` is required (returned as `name`); `assignee_id` sets the owner. Optionally attach it to a contact, company, or deal via `related_to`, and link it to additional records at the same time with `contact_id`/`contact_ids`, `company_id`/`company_ids`, and/or `deal_id`/`deal_ids` — a single task can be linked to multiple contacts, companies, and deals at once. Set `priority` (`low`/`medium`/`high`), a `due_date` (ISO-8601), and `status_id`/`type_id` — resolve these ids first via `task_status_list` / `task_type_list` (the workspace defaults apply when omitted). Some inputs are renamed in the response; see the [field-mapping guide](/guides/field-mapping).