ClickUp
Manage ClickUp workspaces — tasks, lists, folders, comments, time tracking, webhooks
ClickUp is a project management platform covering tasks, lists, folders, spaces, time tracking, docs, and more.
In Agent Forge, the ClickUp integration lets workflows read and write to your ClickUp workspace — create tasks from form submissions, update statuses based on agent decisions, sync time entries, post comments triggered by other systems, and register webhooks for inbound automation.
This is a bring-your-own-key (BYOK) integration. Each user supplies their own ClickUp personal API token.
Usage Instructions
Generate a personal API token from clickup.com → Settings → Apps → API Token. The token starts with pk_. ClickUp passes the token directly in the Authorization header (no Bearer prefix) — the block handles this for you.
To find IDs (workspace, space, folder, list, task), open the resource in the ClickUp UI — the IDs are visible in the URL.
Tools
Account
clickup_get_user- Get the currently authorized userclickup_get_teams- List workspaces the user belongs toclickup_get_team_members- List members of a workspace
Spaces
clickup_get_spaces- List spaces in a workspaceclickup_get_space- Get a single space by ID
Folders
clickup_get_folders- List folders in a spaceclickup_create_folder- Create a folder
Lists
clickup_get_lists- Lists inside a folderclickup_get_folderless_lists- Lists directly in a space (no folder)clickup_get_list- Get a single listclickup_create_list- Create a list inside a folder
Tasks
clickup_get_tasks- List tasks in a list (with rich filters: status, tags, assignees, date ranges, etc.)clickup_get_task- Get a single taskclickup_create_task- Create a task (supports priority, assignees, tags, parent, custom fields)clickup_update_task- Update fields on a task (status, priority, assignees, dates)clickup_delete_task- Delete a task
Comments
clickup_get_task_comments- List comments on a taskclickup_create_task_comment- Add a comment to a task
Time tracking
clickup_get_time_entries- List time entries for a workspace, filterable by date range, assignee, task, list, folder, or space
Webhooks
clickup_get_webhooks- List webhooks on a workspaceclickup_create_webhook- Create a webhookclickup_delete_webhook- Delete a webhook by ID
Common Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | ClickUp personal API token (pk_...) |
team_id | string | Workspace ops | Workspace (team) ID |
space_id | string | Space ops | Space ID |
folder_id | string | Folder ops | Folder ID |
list_id | string | List ops | List ID |
task_id | string | Task ops | Task ID |
name | string | Create ops | Name of the task / list / folder |
description / markdown_description | string | No | Plain-text or Markdown body |
status | string | No | Status label (must match a status configured in ClickUp) |
priority | number | No | 1 (urgent) – 4 (low) |
due_date / start_date | number | No | Unix milliseconds |
assignees | string | No | Comma-separated user IDs |
tags | string | No | Comma-separated tag names |
custom_fields | string (JSON) | No | JSON object of { field_id: value } |
comment_text | string | Comments | Comment body |
Output
| Parameter | Type | Description |
|---|---|---|
data | json | ClickUp response data |
Notes
- Category:
tools - Type:
clickup - BYOK only. The platform does not hold a ClickUp token.
- The personal API token grants full access to the user's workspaces. Treat it like a password.
- For high-volume polling, prefer webhooks (
clickup_create_webhook) over repeatedclickup_get_taskscalls. - Custom Task IDs: tasks created with custom IDs (e.g.
CU-123) requirecustom_task_ids: trueand the workspaceteam_idfor lookup.