/api/v2/todos

Creates a todo on either a task or a deal — provide the description and one of task_id or deal_id. Optionally set assignee_id and closed.

due_date applies only to deal todos.

Task todo

{
  "data": {
    "type": "todos",
    "attributes": {
      "description": "Review the design draft",
      "task_id": 4421188,
      "assignee_id": 314
    }
  }
}

Deal todo

{
  "data": {
    "type": "todos",
    "attributes": {
      "description": "Follow up on contract terms",
      "deal_id": 88401,
      "assignee_id": 314,
      "due_date": "2026-06-01"
    }
  }
}