ClickUp integration

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.

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

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	{}
— Name	string	No	—
— Position	number	No	0

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	{}
— Assignee ID	string	No	—

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	{}
— Assignee ID	string	No	—
— Name	string	No	—
— Parent Checklist Item ID	string	No	—	Nest the target checklist item underneath this parent.
— Resolved	boolean	No	false

Comment: Create

Parameter	Type	Required	Default	Description
Comment On	options	No	task
				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	{}
— Assignee ID	string	No	—
— 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
				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	{}
— Assignee ID	string	No	—
— Comment Text	string	No	—
— Resolved	boolean	No	false

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	{}
				Options: ..., id
— Archived	boolean	No	false

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	{}
— Name	string	No	—

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	{}
— Color	string	No	—
— Description	string	No	—
— Due Date	string	No	—	Due date (ISO 8601 format or date string).
— Multiple Owners	boolean	No	false
— 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	{}
— Add Owners	string	No	—	Comma-separated list of owner user IDs to add.
— Color	string	No	—
— Description	string	No	—
— Due Date	string	No	—
— Name	string	No	—
— 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	{}
— 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	{}
— Name	string	No	—
— Note	string	No	—
— Steps Current	number	No	1
— Steps End	number	No	0
— Steps Start	number	No	0
— Unit	string	No	—

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	{}
— Assignee ID	string	No	—
— Content	string	No	—
— Due Date	string	No	—
— Due Date Time	boolean	No	false
— 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	{}
				Options: ..., id
— Archived	boolean	No	false

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	{}
— Assignee ID	string	No	—
— Content	string	No	—
— Due Date	string	No	—
— Due Date Time	boolean	No	false
— Name	string	No	—
— Priority	number	No	3
— Unset Status	boolean	No	false

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	{}
— Assignees	string	No	—	Comma-separated assignee user IDs.
— Content	string	No	—
— 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
— Is Markdown Content	boolean	No	false
— Notify All	boolean	No	false
— Parent ID	string	No	—
— Priority	number	No	3	1: Urgent, 2: High, 3: Normal, 4: Low
— Start Date	string	No	—
— Start Date Time	boolean	No	false
— 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	{}
				Options: ..., id
— Archived	boolean	No	false
— Assignees	string	No	—	Comma-separated assignee IDs.
— Custom Fields JSON	json	No	—	Custom field filter as JSON array: [{“field_id”:”…”,“operator”:”=”,“value”:”…”}]
— Date Created Greater Than	string	No	—
— Date Created Less Than	string	No	—
— Date Updated Greater Than	string	No	—
— Date Updated Less Than	string	No	—
— Due Date Greater Than	string	No	—
— Due Date Less Than	string	No	—
— Include Closed	boolean	No	false
— Order By	options	No	—
				Options: id, created, updated, dueDate
— Statuses	string	No	—	Comma-separated status names.
— Subtasks	boolean	No	false
— 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	{}
— Add Assignees	string	No	—	Comma-separated assignee IDs to add.
— Content	string	No	—
— Due Date	string	No	—
— Due Date Time	boolean	No	false
— Is Markdown Content	boolean	No	false
— Name	string	No	—
— Notify All	boolean	No	false
— Parent ID	string	No	—
— Priority	number	No	3
— Remove Assignees	string	No	—	Comma-separated assignee IDs to remove.
— Start Date	string	No	—
— Start Date Time	boolean	No	false
— Status	string	No	—
— 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	{}
— Assignee ID	string	No	—
— Billable	boolean	No	true
— Description	string	No	—
— Tags JSON	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	{}
				Options: ..., id
— End Date	string	No	—
— Start Date	string	No	—

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	{}
— Billable	boolean	No	true
— Description	string	No	—

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	{}
— Assignee ID	string	No	—
— Billable	boolean	No	true
— Description	string	No	—
— Duration (Minutes)	number	No	0
— Start	string	No	—
— Task ID	string	No	—

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.

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

ClickUp manages tasks, lists, folders, goals, time entries, comments, checklists and tags in a ClickUp workspace. It is the right tool when a workflow must create, update or delete those items in ClickUp, fetch or list tasks, lists, folders, goals or time entries, list comments and space tags, start or stop a timer, add or remove a task’s tags and lists, or create and delete task dependencies, rather than another project tracker; checklists, checklist items and key results can be created, changed and deleted but not fetched. It returns the affected or fetched ClickUp records as JSON items, with getAll paging through lists.