create_task

create_task

Create a new task in the authenticated user’s team. The task is auto-numbered. If taskStatusId is omitted, the team’s default status is used. Pass taskListIds to attach the task to one or more lists, parentId to make it a subtask, and description for a markdown body that the web app’s collaborative editor will render.

Connected web clients in the team receive a realtime event so the new task shows up in their UI without a refresh.

Input

Field	Type	Required	Description
`title`	string	yes	Task title. Must contain at least one non-whitespace character.
`description`	string	no	CommonMark markdown body. Headings, bold, italic, lists, code blocks, and links are preserved. Inline code, blockquotes, images, and horizontal rules are stripped.
`priority`	string \| null	no	One of `low`, `medium`, `high`, `urgent`, or `null` to leave unset.
`dueDate`	string \| null	no	ISO 8601 date string (`YYYY-MM-DD`) or `null`.
`assigneeIds`	array of string	no	User IDs (UUIDs) to assign. Defaults to nobody if omitted.
`taskStatusId`	number	no	Numeric status ID. Falls back to the team’s default status if not provided.
`parentId`	number	no	If provided, the new task is created as a subtask of this parent.
`taskListIds`	array of number	no	Numeric IDs of lists to attach the task to. Omit to create with no list.

Example call

{
  "title": "Wire up onboarding email",
  "description": "## Steps\n\n- Configure SMTP\n- Send via **Resend**",
  "priority": "high",
  "dueDate": "2026-05-12",
  "assigneeIds": ["u_abc123"],
  "taskListIds": [12, 19]
}

Output

A single text content block containing a JSON object describing the new task.

Field	Type	Description
`id`	number	Numeric ID of the new task.
`number`	number	Auto-incrementing task number within the team.
`title`	string	Task title (trimmed).
`priority`	string \| null	The priority you sent, or `null`.
`dueDate`	string \| null	The due date you sent, or `null`.
`taskStatusId`	number	Numeric ID of the applied status.
`parentId`	number \| null	Parent task ID if this is a subtask, otherwise `null`.
`taskListIds`	array of number	IDs of the lists the task is now attached to.

Example output

{
  "id": 421,
  "number": 87,
  "title": "Wire up onboarding email",
  "priority": "high",
  "dueDate": "2026-05-12",
  "taskStatusId": 1,
  "parentId": null,
  "taskListIds": [12, 19]
}

Errors

The tool returns isError: true with an explanatory text block when:

title is missing or empty
One or more taskListIds don’t belong to the user’s team
parentId doesn’t belong to the user’s team
taskStatusId doesn’t belong to the user’s team