Create, update or find ClickUp tasks

Eight ClickUp steps work with the tasks in your lists:

• ClickUp · Create a task — Adds a task to a list.
• ClickUp · Update a task — Changes a task's name, description, status, priority, due date, assignees or custom fields.
• ClickUp · Add a comment — Comments on a task.
• ClickUp · Find tasks — A list's tasks by status, assignee and due date.
• ClickUp · Get a task — A task's status, priority, assignees, dates and custom fields.
• ClickUp · Attach a file — Attaches a file from an earlier step to a task.
• ClickUp · Create a subtask — Adds a subtask under a task, in the task's list.
• ClickUp · Track time — Records time spent on a task.

Every step except Find tasks and Get a task is tagged Changes data.

Who can do this

Workspace Admins and Editors, on every plan. Viewers see the steps' settings but cannot change them.

Before you start

A ClickUp connection in this workspace — see Connect ClickUp.

Steps

Create a task:

1. Select + where the step should go. In the step picker, open Apps, select ClickUp, then Create a task. Or search ClickUp.
2. In Connection, choose your ClickUp connection.
3. Choose where the task goes: Workspace (Consulace), Space (Delivery), Folder and List (Client onboarding · 24 tasks). For a list straight in the space, choose No folder in Folder — No folder, for lists straight in the space.
4. In Name, type the task's name — Onboard Northwind Logistics.
5. Optional:
   • Description — Markdown.
   • Assignees — Emails, usernames or user ids, separated with commas. For example asha@consulace.com.
   • Status — one of the list's own statuses, each marked Not started, Active, Done or Closed. Empty: the list's first status.
   • Priority — None (the default), Urgent, High, Normal or Low.
   • Due date — A day, or a day and a time — 2026-10-09T11:30:00Z.
   • Tags — Separate several with commas.
   • Custom fields — the list's own fields, each with its type: text, number, money, date, choice, labels, checkbox, people. Read from the list. A drop-down by its option's name; people by email; a checkbox true or false. Only those you fill in are set.
6. Select Run this step to try it. This adds a real task.

Update a task:

1. In Task, the task's id — The task's id or address. Usually the id from the step that created or found it.
2. Fill in only what should change — Empty fields are left as they are.
   • Name, and Description — Markdown. Replaces the description.
   • Status — The status's name, as the task's list has it. For example in progress.
   • Priority — Leave it (the default), Urgent, High, Normal or Low.
   • Due date.
   • Add assignees and Remove assignees — Emails, usernames or user ids, separated with commas.
3. To set custom fields, choose the task's Workspace, Space, Folder and List — Workspace, space, folder and list only to set custom fields — they are the list's own. — then fill them in under Custom fields. Read from the list. Only those you fill in change.

Get a task, Add a comment, Attach a file:

1. In Task, the task's id or address.
2. For Add a comment, type the Comment — Contract signed.
3. For Attach a file, choose the File — A file from an earlier step. — and optionally a Name — Optional — the file's own name otherwise.

Create a subtask:

1. In Parent task, the parent's id or address. The subtask goes in the parent's list.
2. Type the Name — Send the welcome pack — and optionally Description, Assignees, Status (The status's name, as the parent's list has it. Empty: its first status.), Priority, Due date and Tags.

Find tasks:

1. Choose the Workspace, Space, Folder and List.
2. Optional:
   • Statuses — Any of these, separated with commas. Empty: every open status. For example in progress, review.
   • Assignees — Any of these — emails, usernames or user ids, separated with commas.
   • Due after and Due before — dates, 2026-10-01 and 2026-10-31.
   • Include closed tasks — off to begin with.
3. In Most tasks, how many at most — Up to 1,000. It starts at 100.

Track time:

1. Choose the Workspace, and in Task the task's id or address.
2. In Duration, how long — Minutes (90), or hours and minutes — 1h 30m, 1:30.
3. Optional: in Start, when the work began — Empty: the time is taken to have ended now. And Notes.

Every list offers Use a value above it, to give an id from an earlier step instead; Choose from the list goes back.

Output

assignees is a list of usernames, dueDate and createdAt times in UTC. A custom field comes out by its type: a drop-down by its option's name, labels and people as lists of names, a checkbox as true or false.

Good to know

• Find tasks gives one item, with count, the list of tasks and the first. When nothing matches, the run goes down When nothing is found instead, with found set to false — see When a Find step finds nothing.
• Find tasks leaves out closed tasks unless Include closed tasks is on, or Statuses names some — naming statuses takes closed ones of those names too. Subtasks are included.
• Statuses and custom fields belong to the list. Choosing another list in the step loads its own.
• Track time needs time tracking turned on for the ClickUp Space — the Time Tracking ClickApp.
• Each item runs the step once. Ten items add ten tasks.

If something goes wrong

Related

• Connect ClickUp
• Start a workflow from ClickUp task events
• When a Find step finds nothing
• Pass files between steps
• Using what earlier steps found