Tasks

Setting assignees

assignees is an array of the assignees' user ids to be added to a task.

You can view the available user ids using the Get Teams (Workspaces) call.

Setting priority

priority is a number that corresponds to the Priorities available in the ClickUp UI. As in the ClickUp UI, priorities cannot be customized. 1 is Urgent 2 is High 3 is Normal 4 is Low

Setting time estimates

time_estimate values use milliseconds.

Using Custom Fields

You can set Custom Fields using the Create new Task endpoint, but not using the Update task endpoint.

To update Custom Fields on an existing task use the Set Custom Field value endpoint.

Formatting in a task description

To use double quotation marks in the text_content, description, and markdown_description fields you must escape the \" character with \.

For example, including this: \"description\": \"Here is some text. \\\"This is speech.\\\" Additional text.\"

Will look like this in the ClickUp UI: Here is some text. \"This is speech.\" Additional text.

Using Markdown in the task description

Instead of description you can pass markdown_description with valid markdown syntax to add formatting to the task description.

Markdown features that are supported include headers, emphasis, unordered lists, ordered lists, images, links, blockquotes, and inline code.

For more information on markdown syntax, follow GitHub's guide here.