ClickUp

Manage tasks, lists, folders, goals, and time entries in ClickUp

Overview

ClickUp is a project management platform. This tool provides full CRUD operations for tasks, lists, folders, goals, goal key results, checklists, checklist items, comments, space tags, task tags, task lists, task dependencies, time entries, and time entry tags via the ClickUp API v2. Supports 14 resources with operations including create, get, update, delete, and specialized operations like start/stop timers.

Category: Productivity
Tool Name: clickup
Version: 1

Appearance: Icon: si-clickup | Color: #7B68EE

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires ClickUp API credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Checklist	checklist
Checklist Item	checklistItem
Comment	comment
Folder	folder
Goal	goal
Goal Key Result	goalKeyResult
List	list
Space Tag	spaceTag
Task	task
Task Dependency	taskDependency
Task List	taskList
Task Tag	taskTag
Time Entry	timeEntry
Time Entry Tag	timeEntryTag

Operations

Each resource has its own operation list — the operations available to you change as soon as you change the Resource.

Resource	Operation	Value	Description
Checklist	Create	create	Add a checklist to a task
Checklist	Delete	delete	Delete a checklist
Checklist	Update	update	Rename or reposition a checklist
Checklist Item	Create	create	Add an item to a checklist
Checklist Item	Delete	delete	Delete a checklist item
Checklist Item	Update	update	Rename, reassign, resolve or re-nest a checklist item
Comment	Create	create	Add a comment to a task, list or view
Comment	Delete	delete	Delete a comment
Comment	Get Many	getAll	Read the comments on a task, list or view
Comment	Update	update	Change a comment’s text, assignee or resolved state
Folder	Create	create	Create a folder in a space
Folder	Delete	delete	Delete a folder
Folder	Get	get	Retrieve one folder
Folder	Get Many	getAll	Retrieve the folders in a space
Folder	Update	update	Rename a folder
Goal	Create	create	Create a goal in the workspace
Goal	Delete	delete	Delete a goal
Goal	Get	get	Retrieve one goal
Goal	Get Many	getAll	Retrieve the workspace’s goals
Goal	Update	update	Change a goal’s name, description, colour, due date or owners
Goal Key Result	Create	create	Add a key result to a goal
Goal Key Result	Delete	delete	Delete a key result
Goal Key Result	Update	update	Record progress on a key result
List	Create	create	Create a list in a folder or directly in a space
List	Custom Fields	customFields	Retrieve the custom fields defined on a list
List	Delete	delete	Delete a list
List	Get	get	Retrieve one list
List	Get Many	getAll	Retrieve the lists in a folder or space
List	Member	member	Retrieve the members of a list
List	Update	update	Change a list’s name, content, due date, priority or status
Space Tag	Create	create	Create a tag in a space
Space Tag	Delete	delete	Delete a space tag
Space Tag	Get Many	getAll	Retrieve the tags defined in a space
Space Tag	Update	update	Rename or recolour a space tag
Task	Create	create	Create a task in a list
Task	Delete	delete	Delete a task
Task	Get	get	Retrieve one task
Task	Get Many	getAll	Retrieve the tasks in a list
Task	Member	member	Retrieve the members of a task
Task	Set Custom Field	setCustomField	Write a value into one custom field on a task
Task	Update	update	Change a task’s fields, status or assignees
Task Dependency	Create	create	Make one task depend on another
Task Dependency	Delete	delete	Remove a dependency between two tasks
Task List	Add	add	Add a task to an additional list
Task List	Remove	remove	Remove a task from a list
Task Tag	Add	add	Put a tag on a task
Task Tag	Remove	remove	Take a tag off a task
Time Entry	Create	create	Log a completed block of time against a task
Time Entry	Delete	delete	Delete a time entry
Time Entry	Get	get	Retrieve one time entry, or the timer running now
Time Entry	Get Many	getAll	Retrieve the workspace’s time entries
Time Entry	Start	start	Start a running timer on a task
Time Entry	Stop	stop	Stop the running timer
Time Entry	Update	update	Change a time entry’s task, start, duration or billable flag
Time Entry Tag	Add	add	Tag one or more time entries
Time Entry Tag	Get Many	getAll	Retrieve the tags used on time entries
Time Entry Tag	Remove	remove	Remove tags from one or more time entries

Parameters

Parameters are shown by the Resource and Operation you pick. The location selectors — Team ID, Space ID, Folderless List, Folder ID and List ID — repeat across many resources because ClickUp addresses everything through the workspace hierarchy; fill in the ones the operation you chose actually needs.

Checklist: Create

Parameter	Type	Required	Default	Description
Task ID (task)	string	Yes	—	The task ID to create the checklist on.
Name	string	Yes	—	The name of the checklist.

Checklist: Delete

Parameter	Type	Required	Default	Description
Checklist ID	string	Yes	—	The checklist ID.

Checklist: Update

Parameter	Type	Required	Default	Description
Checklist ID	string	Yes	—	The checklist ID.
Update Fields	collection	No	{}	Fields to change on the checklist. Anything you leave out keeps its current value.
— Name	string	No	—	New name for the checklist.
— Position	number	No	0	New position for the checklist.

Checklist Item: Create

Parameter	Type	Required	Default	Description
Checklist ID	string	Yes	—	The checklist ID.
Name	string	Yes	—	The name of the checklist item.
Additional Fields	collection	No	{}	Optional fields to set on the new checklist item.
— Assignee ID (assignee)	string	No	—	User ID to assign the item to.

Checklist Item: Delete

Parameter	Type	Required	Default	Description
Checklist ID	string	Yes	—	The checklist ID.
Checklist Item ID	string	Yes	—	The checklist item ID.

Checklist Item: Update

Parameter	Type	Required	Default	Description
Checklist ID	string	Yes	—	The checklist ID.
Checklist Item ID	string	Yes	—	The checklist item ID.
Update Fields	collection	No	{}	Fields to change on the checklist item.
— Assignee ID (assignee)	string	No	—	User ID to assign the item to.
— Name	string	No	—	New name for the item.
— Parent Checklist Item ID (parent)	string	No	—	Nest the target checklist item underneath this parent.
— Resolved	boolean	No	false	Whether the item is checked off.

Comment: Create

Parameter	Type	Required	Default	Description
Comment On	options	No	task	Which kind of ClickUp object the comment is posted on.
				Options: list, task, view
ID	string	Yes	—	The ID of the task, list, or view.
Comment Text	string	No	—	The text content of the comment.
Additional Fields	collection	No	{}	Optional fields to set on the new comment.
— Assignee ID (assignee)	string	No	—	User ID to assign the comment to.
— Notify All	boolean	No	false	Whether creation notifications will be sent to everyone.

Comment: Delete

Parameter	Type	Required	Default	Description
Comment ID	string	Yes	—	The comment ID.

Comment: Get Many

Parameter	Type	Required	Default	Description
Comments On	options	No	task	Which kind of ClickUp object to read comments from.
				Options: list, task, view
ID	string	Yes	—	The ID of the task, list, or view.
Limit	number	No	50	Max number of comments to return.

Comment: Update

Parameter	Type	Required	Default	Description
Comment ID	string	Yes	—	The comment ID.
Update Fields	collection	No	{}	Fields to change on the comment.
— Assignee ID (assignee)	string	No	—	User ID to assign the comment to.
— Comment Text	string	No	—	Replacement text for the comment.
— Resolved	boolean	No	false	Whether the comment is marked resolved.

Folder: Create

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
Name	string	Yes	—	The name of the folder.

Folder: Delete

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folder ID	string	No	—	The Folder ID. Required when folderless is false.

Folder: Get

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folder ID	string	No	—	The Folder ID. Required when folderless is false.

Folder: Get Many

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
Limit	number	No	50	Max number of folders to return.
Filters	collection	No	{}	Optional filters applied to the folder listing.
— Archived	boolean	No	false	Whether to return archived folders.

Folder: Update

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
Update Fields	collection	No	{}	Fields to change on the folder.
— Name	string	No	—	New name for the folder.

Goal: Create

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Name	string	Yes	—	The name of the goal.
Additional Fields	collection	No	{}	Optional fields to set on the new goal.
— Color	string	No	—	Colour for the goal.
— Description	string	No	—	Description for the goal.
— Due Date	string	No	—	Due date (ISO 8601 format or date string).
— Multiple Owners	boolean	No	false	Whether the goal may have more than one owner.
— Owners	string	No	—	Comma-separated list of owner user IDs.

Goal: Delete

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Goal ID	string	Yes	—	The goal ID.

Goal: Get

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Goal ID	string	Yes	—	The goal ID.

Goal: Get Many

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Limit	number	No	50	Max number of goals to return.

Goal: Update

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Goal ID	string	Yes	—	The goal ID.
Update Fields	collection	No	{}	Fields to change on the goal.
— Add Owners	string	No	—	Comma-separated list of owner user IDs to add.
— Color	string	No	—	Colour for the goal.
— Description	string	No	—	Description for the goal.
— Due Date	string	No	—	New due date for the goal.
— Name	string	No	—	New name for the goal.
— Remove Owners	string	No	—	Comma-separated list of owner user IDs to remove.

Goal Key Result: Create

Parameter	Type	Required	Default	Description
Goal ID	string	Yes	—	The goal ID.
Name	string	Yes	—	The name of the key result.
Type	options	Yes	number	The type of key result.
				Options: automatic, boolean, currency, number, percentage
Additional Fields	collection	No	{}	Optional fields to set on the new key result.
— List IDs	string	No	—	Comma-separated list IDs.
— Owners	string	No	—	Comma-separated owner user IDs.
— Steps Start	number	No	0	Required for Percentage, Automatic, Number, and Currency types.
— Steps End	number	No	0	Required for Percentage, Automatic, Number, and Currency types.
— Task IDs	string	No	—	Comma-separated task IDs.
— Unit	string	No	—	For Number and Currency types. Currency unit must be a valid currency code.

Goal Key Result: Delete

Parameter	Type	Required	Default	Description
Key Result ID	string	Yes	—	The key result ID.

Goal Key Result: Update

Parameter	Type	Required	Default	Description
Key Result ID	string	Yes	—	The key result ID.
Update Fields	collection	No	{}	Fields to change on the key result.
— Name	string	No	—	New name for the key result.
— Note	string	No	—	Note to record alongside the update.
— Steps Current	number	No	1	Current progress value.
— Steps End	number	No	0	Target value that counts as complete.
— Steps Start	number	No	0	Value the progress is measured from.
— Unit	string	No	—	Unit the values are expressed in.

List: Create

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Name	string	Yes	—	The name of the list.
Additional Fields	collection	No	{}	Optional fields to set on the new list.
— Assignee ID (assignee)	string	No	—	User ID to assign the list to.
— Content	string	No	—	Description content for the list.
— Due Date	string	No	—	Due date for the list.
— Due Date Time	boolean	No	false	Whether the due date carries a time of day.
— Priority	number	No	3	1: Urgent, 2: High, 3: Normal, 4: Low
— Status	string	No	—	Status name for the list.

List: Custom Fields

Parameter	Type	Required	Default	Description
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.

List: Delete

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.

List: Get

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.

List: Get Many

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Limit	number	No	50	Max number of results to return.
Filters	collection	No	{}	Optional filters applied to the results.
— Archived	boolean	No	false	Whether to return archived lists.

List: Member

Parameter	Type	Required	Default	Description
List ID (id)	string	Yes	—	The list ID.
Return All	boolean	No	true	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return.

List: Update

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Update Fields	collection	No	{}	Fields to change on the list.
— Assignee ID (assignee)	string	No	—	User ID to assign the list to.
— Content	string	No	—	Description content for the list.
— Due Date	string	No	—	New due date for the list.
— Due Date Time	boolean	No	false	Whether the due date carries a time of day.
— Name	string	No	—	New name for the list.
— Priority	number	No	3	1: Urgent, 2: High, 3: Normal, 4: Low
— Unset Status	boolean	No	false	Clear the status currently set on the list.

Space Tag: Create

Parameter	Type	Required	Default	Description
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Name	string	Yes	—	The tag name.
Foreground Color	string	Yes	#000000	Foreground color hex code.
Background Color	string	Yes	#000000	Background color hex code.

Space Tag: Delete

Parameter	Type	Required	Default	Description
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Name	string	Yes	—	The tag name.

Space Tag: Get Many

Parameter	Type	Required	Default	Description
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Return All	boolean	No	true	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of tags to return.

Space Tag: Update

Parameter	Type	Required	Default	Description
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Name	string	Yes	—	The tag name.
New Name	string	Yes	—	New name to set for the tag.
Foreground Color	string	Yes	#000000	Foreground color hex code.
Background Color	string	Yes	#000000	Background color hex code.

Task: Create

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Name	string	Yes	—	The name of the task.
Additional Fields	collection	No	{}	Optional fields to set on the new task.
— Assignees	string	No	—	Comma-separated assignee user IDs.
— Content	string	No	—	Description body for the task.
— Custom Fields JSON	json	No	—	Custom fields as JSON: [{"id": "", "value": ""}]
— Due Date	string	No	—	Due date (ISO 8601 or date string).
— Due Date Time	boolean	No	false	Whether the due date carries a time of day.
— Is Markdown Content (markdownContent)	boolean	No	false	Send Content as markdown rather than plain text.
— Notify All	boolean	No	false	Whether everyone on the task is notified.
— Parent ID (parentId)	string	No	—	ID of the parent task, which makes the new task a subtask.
— Priority	number	No	3	1: Urgent, 2: High, 3: Normal, 4: Low
— Start Date	string	No	—	Start date for the task.
— Start Date Time	boolean	No	false	Whether the start date carries a time of day.
— Status	string	No	—	Status name for the task.
— Tags	string	No	—	Comma-separated tag names.
— Time Estimate	number	No	0	Time estimate in minutes.

Task: Delete

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Task ID (id)	string	Yes	—	The task ID.

Task: Get

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Task ID (id)	string	Yes	—	The task ID.
Include Subtasks	boolean	No	false	Whether to also fetch and include subtasks for this task.
Include Markdown Description	boolean	No	false	Whether to include the markdown_description field in the response.

Task: Get Many

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Return All	boolean	No	true	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return.
Filters	collection	No	{}	Optional filters applied to the task query.
— Archived	boolean	No	false	Whether to return archived tasks.
— Assignees	string	No	—	Comma-separated assignee IDs.
— Custom Fields JSON	json	No	—	Custom field filter as a JSON array such as [{"field_id":"...","operator":"=","value":"..."}], where each ... is a value you supply.
— Date Created Greater Than (dateCreatedGt)	string	No	—	Only tasks created after this date.
— Date Created Less Than (dateCreatedLt)	string	No	—	Only tasks created before this date.
— Date Updated Greater Than (dateUpdatedGt)	string	No	—	Only tasks updated after this date.
— Date Updated Less Than (dateUpdatedLt)	string	No	—	Only tasks updated before this date.
— Due Date Greater Than (dueDateGt)	string	No	—	Only tasks due after this date.
— Due Date Less Than (dueDateLt)	string	No	—	Only tasks due before this date.
— Include Closed	boolean	No	false	Whether to include closed tasks.
— Order By	options	No	—	Field the results are sorted by.
				Options: id, created, updated, dueDate
— Statuses	string	No	—	Comma-separated status names.
— Subtasks	boolean	No	false	Whether to include subtasks.
— Tags	string	No	—	Comma-separated tag names.

Task: Member

Parameter	Type	Required	Default	Description
Task ID (id)	string	Yes	—	The task ID.
Return All	boolean	No	true	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return.

Task: Set Custom Field

Parameter	Type	Required	Default	Description
Task ID (task)	string	Yes	—	The task ID for the custom field.
Field ID	string	Yes	—	The custom field ID.
Value Is JSON	boolean	No	false	Whether the value is JSON and should be parsed.
Value	string	Yes	—	The value to set on the custom field.

Task: Update

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Task ID (id)	string	Yes	—	The task ID.
Update Fields	collection	No	{}	Fields to change on the task.
— Add Assignees	string	No	—	Comma-separated assignee IDs to add.
— Content	string	No	—	Description body for the task.
— Due Date	string	No	—	New due date for the task.
— Due Date Time	boolean	No	false	Whether the due date carries a time of day.
— Is Markdown Content (markdownContent)	boolean	No	false	Send Content as markdown rather than plain text.
— Name	string	No	—	New name for the task.
— Notify All	boolean	No	false	Whether everyone on the task is notified.
— Parent ID (parentId)	string	No	—	ID of the parent task, which makes this task a subtask.
— Priority	number	No	3	1: Urgent, 2: High, 3: Normal, 4: Low
— Remove Assignees	string	No	—	Comma-separated assignee IDs to remove.
— Start Date	string	No	—	New start date for the task.
— Start Date Time	boolean	No	false	Whether the start date carries a time of day.
— Status	string	No	—	Status name for the task.
— Time Estimate	number	No	0	Time estimate in minutes.

Task Dependency: Create

Parameter	Type	Required	Default	Description
Task ID (task)	string	Yes	—	The task ID.
Depends On Task ID	string	Yes	—	The ID of the task this depends on.

Task Dependency: Delete

Parameter	Type	Required	Default	Description
Task ID (task)	string	Yes	—	The task ID.
Depends On Task ID	string	Yes	—	The ID of the task this depends on.

Task List: Add

Parameter	Type	Required	Default	Description
Task ID (taskId)	string	Yes	—	The task ID.
List ID (listId)	string	Yes	—	The list ID.

Task List: Remove

Parameter	Type	Required	Default	Description
Task ID (taskId)	string	Yes	—	The task ID.
List ID (listId)	string	Yes	—	The list ID.

Task Tag: Add

Parameter	Type	Required	Default	Description
Task ID (taskId)	string	Yes	—	The task ID.
Tag Name	string	Yes	—	The tag name.

Task Tag: Remove

Parameter	Type	Required	Default	Description
Task ID (taskId)	string	Yes	—	The task ID.
Tag Name	string	Yes	—	The tag name.

Time Entry: Create

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Start	string	Yes	—	Start time (ISO 8601 or date string).
Duration (Minutes)	number	Yes	0	Duration in minutes.
Task ID (task)	string	Yes	—	The task ID for the time entry.
Additional Fields	collection	No	{}	Optional fields to set on the new time entry.
— Assignee ID (assignee)	string	No	—	User ID the time is logged for.
— Billable	boolean	No	true	Whether the logged time is billable.
— Description	string	No	—	Description for the time entry.
— Tags JSON (tags)	json	No	—	Tags as JSON array: [{"name":"tag1","tag_bg":"#fff","tag_fg":"#000"}]

Time Entry: Delete

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Time Entry ID	string	Yes	—	The time entry ID.

Time Entry: Get

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Running	boolean	No	false	Whether to return just the current running time entry.
Time Entry ID	string	No	—	The time entry ID (required when Running is false).

Time Entry: Get Many

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	5	Max number of time entries to return.
Filters	collection	No	{}	Optional date range applied to the time entry query.
— End Date (end_date)	string	No	—	Only time entries before this date.
— Start Date (start_date)	string	No	—	Only time entries after this date.

Time Entry: Start

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Task ID (task)	string	Yes	—	The task ID for the time entry.
Additional Fields	collection	No	{}	Optional fields to set on the timer you are starting.
— Billable	boolean	No	true	Whether the logged time is billable.
— Description	string	No	—	Description for the time entry.

Time Entry: Stop

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.

Time Entry: Update

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Space ID	string	No	—	The Space ID. Find it in the Space settings or URL.
Folderless List	boolean	No	false	Whether the list has no parent folder (folderless).
Folder ID	string	No	—	The Folder ID. Required when folderless is false.
List ID (list)	string	No	—	The List ID.
Time Entry ID	string	Yes	—	The time entry ID.
Update Fields	collection	No	{}	Fields to change on the time entry.
— Assignee ID (assignee)	string	No	—	User ID the time is logged for.
— Billable	boolean	No	true	Whether the logged time is billable.
— Description	string	No	—	Description for the time entry.
— Duration (Minutes)	number	No	0	New duration in minutes.
— Start	string	No	—	New start time.
— Task ID (task)	string	No	—	Move the entry onto this task.

Time Entry Tag: Add

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Time Entry IDs	string	Yes	—	Comma-separated time entry IDs.
Tags JSON	json	Yes	—	Tags as JSON array: [{"name":"tag","tag_bg":"#fff","tag_fg":"#000"}]

Time Entry Tag: Get Many

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	5	Max number of tags to return.

Time Entry Tag: Remove

Parameter	Type	Required	Default	Description
Team ID	string	Yes	—	The Workspace (Team) ID. Find it at: ClickUp Settings > Workspaces.
Time Entry IDs	string	Yes	—	Comma-separated time entry IDs.
Tag Names	string	Yes	—	Comma-separated tag names to remove.

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

One input item always produces exactly one output item — this node never fans out. Binary data on the input item is forwarded unchanged. What lands in the item JSON depends on whether the ClickUp call returned a single record or a collection:

• A single record (create, get, update, and the delete-style calls) is merged onto the incoming item JSON. Fields you were already carrying stay put, and any ClickUp field with the same name wins. So after a task create the item still has your upstream fields plus ClickUp’s id, name, url, status and the rest of the task record.
• A collection is written to a results array on a new item JSON — { "results": [ … ] }. In this case the incoming item JSON is replaced, not merged, so anything you needed from upstream must be captured before the node. To turn the array into one item per record, follow the node with a Split Out node on results.

These operations return a collection, so they produce the results shape:

Resource	Operations returning results
Comment	getAll
Folder	getAll
Goal	getAll
List	customFields, getAll, member
Space Tag	getAll
Task	getAll, member
Time Entry	getAll
Time Entry Tag	getAll

Every other operation returns a single object. Some of them have nothing meaningful to return and answer with just { "success": true } merged onto the item — Checklist delete; Checklist Item delete; Comment delete and update; Folder delete; Goal delete; Goal Key Result delete; List delete; Space Tag create, delete and update; Task delete; both Task Dependency operations; both Task List operations; both Task Tag operations; and Time Entry Tag add and remove. Check for success rather than for a record ID after those calls.

Reference the result downstream by expression — {{ $json.id }} for a created task, {{ $json.results }} for a listing.

Usage Examples

• Create a task in a ClickUp list
• Get all tasks from a list
• Update task status in ClickUp
• Start a time entry for a task
• Add a comment to a task
• Create a folder in a space

Example Configuration

Create a task in a list inside a folder:

{
  "type": "clickup",
  "parameters": {
    "resource": "task",
    "operation": "create",
    "team": "12345678",
    "space": "87654321",
    "folderless": false,
    "folder": "11111111",
    "list": "22222222",
    "name": "{{ $json.title }}",
    "additionalFields": {
      "assignees": "4823019",
      "content": "{{ $json.summary }}",
      "dueDate": "2026-12-31",
      "priority": 2,
      "status": "to do",
      "tags": "urgent,inbound"
    }
  }
}

Read a bounded, filtered page of tasks back out of that list:

{
  "type": "clickup",
  "parameters": {
    "resource": "task",
    "operation": "getAll",
    "team": "12345678",
    "space": "87654321",
    "folderless": false,
    "folder": "11111111",
    "list": "22222222",
    "returnAll": false,
    "limit": 50,
    "filters": {
      "archived": false,
      "assignees": "4823019",
      "includeClosed": false,
      "statuses": "to do,in progress",
      "orderBy": "created"
    }
  }
}

Write one custom field value onto an existing task:

{
  "type": "clickup",
  "parameters": {
    "resource": "task",
    "operation": "setCustomField",
    "task": "{{ $json.taskId }}",
    "field": "0a52c486-5f9c-4b2e-9a3d-77c1e0a1f9b2",
    "jsonParse": false,
    "value": "{{ $json.orderNumber }}"
  }
}

Start a billable timer on a task:

{
  "type": "clickup",
  "parameters": {
    "resource": "timeEntry",
    "operation": "start",
    "team": "12345678",
    "task": "{{ $json.taskId }}",
    "additionalFields": {
      "billable": true,
      "description": "Working on {{ $json.title }}"
    }
  }
}

Post a build result as a comment and notify the watchers:

{
  "type": "clickup",
  "parameters": {
    "resource": "comment",
    "operation": "create",
    "commentOn": "task",
    "id": "{{ $json.taskId }}",
    "commentText": "Build {{ $json.buildNumber }} finished with status {{ $json.status }}.",
    "additionalFields": {
      "assignee": "4823019",
      "notifyAll": true
    }
  }
}

Create a sprint list inside an existing folder:

{
  "type": "clickup",
  "parameters": {
    "resource": "list",
    "operation": "create",
    "team": "12345678",
    "space": "87654321",
    "folderless": false,
    "folder": "11111111",
    "name": "Sprint {{ $json.sprintNumber }}",
    "additionalFields": {
      "content": "Created automatically from the release pipeline",
      "priority": 3
    }
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

Manage ClickUp tasks, lists, folders, goals, time entries, comments, checklists, and tags via the ClickUp API.