Skip to main content

Create a task

POST 
/tasks

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.

Request​

Responses​

Created