--- title: "Create a task" method: POST path: "/public-api/v1/tasks" tags: ["Tasks"] --- # Create a task `POST /public-api/v1/tasks` ## Request - Base URL: `https://app.hellobonsai.com` - URL: `https://app.hellobonsai.com/public-api/v1/tasks` - Auth: one of: - OAuth 2 - Authorization code: `https://app.hellobonsai.com/oauth/authorize` - Token URL: `https://app.hellobonsai.com/oauth/token` - HTTP bearer Creates a task. Only `title` is required — a task does not need a project, an assignee or a date. Assign the task with `assignee_member_id`: a team member id from `GET /public-api/v1/team_members`, or `me` for whoever the token belongs to. Responses report the assignee twice, as `assignee_member_id` and as the user's `assignee_id`, but only `assignee_member_id` is writable. ## Subtasks Send `parent_task_uuid` to create the task underneath an existing one. A subtask takes its project and billable setting from its parent, so `project_id` cannot be sent alongside `parent_task_uuid`. `billable` can still be set explicitly. Tasks nest two levels deep at most — a top-level task, a subtask, and a subtask of that. Pointing at a parent that is already at the bottom fails with `422 invalid_value`. Read a task's children with `GET /public-api/v1/tasks/{uuid}/subtasks`. ## Request body - object - `task` object, required - `title` string, required: Task title. Required. - `project_id` integer, nullable: Id of the project the task belongs to. Leave it out for a task that stands on its own. Cannot be combined with `parent_task_uuid` — a subtask takes its project from its parent. Find one with `GET /public-api/v1/projects`. - `deal_id` integer, nullable: Id of the deal to put the task on. Independent of `project_id` — a task can sit on a deal, a project, both or neither. Needs permission to create deals; without it the request fails with `422 not_accessible`. A deal that is not in your account fails the same way. Find one with `GET /public-api/v1/deals`. - `parent_task_uuid` string, nullable: `uuid` of the task to nest this one under. The subtask takes its project and billable setting from the parent, so `project_id` cannot be sent with it. A parent that is not in your account fails with `422 not_accessible`; a parent already two levels deep fails with `422 invalid_value`. - `assignee_member_id` union: Who the task is for: a team member id, or `me` for whoever the token belongs to. Send `null` or leave it out for an unassigned task. Find ids with `GET /public-api/v1/team_members` — use the `company_member_id` field. - integer, nullable: Team member id of the assignee. - 'me': Assigns the task to whoever the token belongs to. - `priority` 'urgent' | 'high' | 'medium' | 'low' | 'null', nullable: How urgent the task is. - `due_date` string, date, nullable: Date the task is due. Leave it out for an unscheduled task. Cannot be earlier than `start_date` when you send both. - `start_date` string, date, nullable: Date work on the task starts. Cannot be later than `due_date` when you send both. - `description` string, nullable: What the task involves. Accepts an HTML fragment for formatting — `

`, ``, `