ClickUp

This connector uses the ClickUp API v2 (clickup.com/api).

Setup:

1. Sign in to ClickUp → top-right avatar → Settings → Apps → API Token → Generate (personal token).
2. Copy the token (starts with pk_). Set CLICKUP_API_TOKEN.

Authentication: header Authorization: ${CLICKUP_API_TOKEN} — no Bearer or Token prefix, just the raw key. The adapter sets this via API_KEY profile.

Hierarchy: Workspace (=Team) → Space → Folder (optional) → List → Task → Subtask. Lists can also exist directly inside a Space without a Folder. Discover IDs top-down: clickup_list_teams (returns workspaces, oddly called 'teams' in the API) → clickup_list_spaces(teamId) → clickup_list_folders(spaceId) → clickup_list_lists(folderId) OR clickup_list_folderless_lists(spaceId).

Task IDs: every task has an id (e.g. abc123). The same task can also be addressed by custom_id (the human-readable like 'PROJ-42') if your workspace enabled custom task IDs — set custom_task_ids=true in calls that use custom IDs.

Statuses are per-list: each list has its own status set ('Open', 'In Progress', 'Done'). To move a task, set status to a status name (case-insensitive) that exists on the task's current list.

Custom fields: arrays of {id, value} on every task. Discover via clickup_get_list_custom_fields(listId).

Assignees: array of user IDs (NOT emails). Get user IDs from clickup_list_team_members(teamId).

Date fields: Unix timestamp in MILLISECONDS (not seconds), e.g. 1717200000000.

Pagination: most list endpoints return up to 100 by default. Some support page (0-indexed) + order_by + reverse.

Rate limits: 100 req/min for Free Forever, scales up with plan. On 429 honor X-RateLimit-Reset (Unix timestamp).

Out of scope here: webhooks, automations, dependencies, goals/targets, attachments upload (use external URL), chat, dashboards, sprints.