create_task_list

create_task_list

Create a new task list in the authenticated user’s team. The caller is automatically granted access to the new list.

Input

Field	Type	Required	Description
name	string	yes	Name of the new task list. Must contain at least one non-whitespace character.
color	string	no	Color tag for the list. Defaults to Green. See valid values below.

Valid color values: Gray, Red, Orange, Yellow, Amber, Lime, Green, Teal, Sky, Blue, Purple, Pink.

Example call

{
  "name": "Q3 launch",
  "color": "Blue"
}

Output

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

Field	Type	Description
id	number	Numeric ID of the new list.
name	string	Display name of the list.
color	string	Color tag the list was created with.
isArchived	boolean	Always false for a freshly created list.

Example output

{
  "id": 27,
  "name": "Q3 launch",
  "color": "Blue",
  "isArchived": false
}