<!-- BusyBot node reference — https://busybot.net/tools/clickup/ -->

> Node: ClickUp (`clickup`) · Action · v1
> Category: Productivity · Credentials: ClickUp API (`clickupApi`)
> Updated: 2026-08-16

# 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](https://busybot.net/credentials/clickup-api/) 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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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.