ClickUp

Overview

Automate ClickUp from your workflows. The ClickUp node covers the full hierarchy — Workspace → Space → Folder → List → Task — with task and comment write operations plus read operations at every level so a workflow (or an AI agent) can discover the IDs it needs. Authenticates with a personal API token, which works across every ClickUp workspace your user belongs to.

Operations

• Task — Create — create a task in a list, with name, description, status, priority, due/start dates, assignees, tags, and an optional parent task (subtask).
• Task — Update — change any of those fields on an existing task, including adding and removing assignees.
• Task — Get — fetch a task by ID, optionally with subtasks and the markdown description (preserves links and formatting).
• Task — Get Many — list a list's tasks with status filters, closed/subtask inclusion, and paging (100 per page).
• Task — Delete — delete a task by ID.
• Comment — Create / Get Many — post a comment on a task (optionally notifying everyone) or read a task's comments.
• List — Get / Get Many / Get Members — fetch a list (including its statuses), enumerate the lists in a folder or the folderless lists in a space, and look up list members to find assignee user IDs.
• Folder / Space / Workspace — Get Many — walk the hierarchy from the top to discover every ID the operations above need.

Task fields

Create and Update render labeled inputs for the common fields. Values support {{variables}} from upstream nodes. Priority is 1 (Urgent) to 4 (Low); dates accept ISO (2026-07-31) or epoch milliseconds; assignees are comma-separated numeric user IDs. An Extra Fields (JSON) box merges anything else — custom fields, time estimates — into the request body:

{
  "time_estimate": 8640000,
  "custom_fields": [{ "id": "…", "value": "{{$json.value}}" }]
}

Output ($json)

• {{$json.id}} — the task ID
• {{$json.url}} — direct link to the task
• {{$json.status.status}} — the task's status name
• {{$json.tasks}} — the array of tasks (Get Many)
• {{$json.lists}} / {{$json.comments}} — arrays from the list and comment reads

Common Use Cases

• Create a ClickUp task when a form is submitted or an email arrives.
• Post AI-generated summaries as comments on existing tasks.
• Move tasks through statuses from external events (payments, approvals).
• Let an Agent Loop create and update tasks as callable tools.

Required Credentials