ClickUp
Turn requests and orders into ClickUp work, and keep status in step across your tools.
28 ways to read, 26 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with ClickUp, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Add checklist item
checklist_items.createApproval by rule - Create checklist
checklists.createApproval by rule - List comment replies
comment_replies.listRead
Example flow
- ClickUp · List comment replies
comment_replies.listDone - ClickUp · Add checklist item
checklist_items.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches ClickUp.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to ClickUp
- ClickUp's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
ClickUp workspaces, spaces, folders, lists, tasks, subtasks, comments, checklists, custom fields, time entries, goals, tags, views and docs.
ClickUp API docs- Source actions
- 28
- Destination actions
- 26
- Data types
- 28
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
checklist items2
- Add checklist itemDestinationNot retried automaticallyApproval before production
Adds an item to a checklist, optionally assigned.
- Update checklist itemDestinationProvider duplicate protectionApproval before production
Resolves, renames, assigns or nests a checklist item.
checklists2
- Create checklistDestinationNot retried automaticallyApproval before production
Adds a checklist to a task.
- Update checklistDestinationProvider duplicate protectionApproval before production
Renames or reorders a checklist.
comment replies2
- Reply to commentDestinationNot retried automaticallyApproval before production
Adds a threaded reply without notifying all watchers.
- List comment repliesSource
Threaded replies to a comment.
comments3
- Add task commentDestinationNot retried automaticallyApproval before production
Adds a comment to a task without notifying all watchers.
- List task commentsSource
Most recent comments on a task.
- Edit commentDestinationProvider duplicate protectionApproval before production
Edits a comment's text, resolves it or assigns it.
custom field values1
- Set custom field valueDestinationProvider duplicate protectionApproval before production
Sets a custom field value on a task.
custom fields1
- List custom fieldsSource
Custom field definitions accessible on a list.
dependencies1
- Add task dependencyDestinationProvider duplicate protectionApproval before production
Marks a task as waiting on another task.
doc pages1
- List doc pagesSource
Pages of a Doc with their content as Markdown or plain text.
docs1
- List docsSource
ClickUp Docs in the workspace, optionally under a space, folder or list.
folderless lists1
- List folderless listsSource
Lists that sit directly in a space.
folders4
- Create folderDestinationNot retried automaticallyApproval before production
Creates a folder in a space.
- Get folderSource
Reads a folder with its lists and statuses.
- List foldersSource
Folders in a space.
- Rename folderDestinationProvider duplicate protectionApproval before production
Renames a folder.
goals4
- Create goalDestinationNot retried automaticallyApproval before production
Creates a goal with owners and a due date.
- Get goalSource
Reads a goal with its key results.
- List goalsSource
Goals in the workspace with completion and owners.
- Update goalDestinationProvider duplicate protectionApproval before production
Renames, re-dates or recolours a goal and adds or removes owners.
key results2
- Create key resultDestinationNot retried automaticallyApproval before production
Adds a key result (target) to a goal.
- Update key result progressDestinationProvider duplicate protectionApproval before production
Sets a key result's current value with an optional note.
list comments1
- List list commentsSource
Comments posted on a list (list chat).
list members1
- List list membersSource
Members who can access a list.
lists4
- Create listDestinationNot retried automaticallyApproval before production
Creates a list in a folder, or directly in a space when no folder is given.
- Get listSource
Reads a list with its statuses, owner and dates.
- List lists in a folderSource
Lists inside a folder.
- Update listDestinationProvider duplicate protectionApproval before production
Renames a list or changes its description, due date, priority or owner.
spaces4
- Create spaceDestinationNot retried automaticallyApproval before production
Creates a space in the workspace with the standard ClickApps (due dates, time tracking, tags, estimates, checklists, custom fields, dependencies).
- Get spaceSource
Reads a space with statuses and enabled ClickApps.
- List spacesSource
Spaces in the configured workspace.
- Update spaceDestinationProvider duplicate protectionApproval before production
Renames or recolours a space, or changes privacy and multiple assignees.
subtasks1
- List subtasksSource
Subtasks of a task.
tags2
- Create space tagDestinationProvider duplicate protectionApproval before production
Creates a task tag in a space. Tag names are unique per space.
- List space tagsSource
Task tags defined in a space.
task links1
- Link tasksDestinationProvider duplicate protectionApproval before production
Links two tasks (a non-blocking relationship).
task tags1
- Add tag to taskDestinationProvider duplicate protectionApproval before production
Adds an existing space tag to a task.
tasks5
- Create task or subtaskDestinationNot retried automaticallyApproval before production
Creates a task in a list; supply a parent task ID to create a subtask.
- Get taskSource
Reads one task with subtasks, checklists, tags, custom fields and dependencies.
- List tasks in a listSourceIncremental
Tasks and subtasks in a ClickUp list, including closed tasks.
- Search workspace tasksSourceIncremental
Filters tasks across the workspace by space, list, status, assignee, tag and updated or due dates.
- Update taskDestinationProvider duplicate protectionApproval before production
Updates supplied fields on a task. Custom fields are updated through their own endpoint and are not changed here.
time entries4
- Create time entryDestinationNot retried automaticallyApproval before production
Records time against a task.
- Get time entrySource
Reads one time entry with its task, tags and billable flag.
- List time entriesSource
Time entries in the workspace for a date range (defaults to the last 30 days for the token owner).
- Update time entryDestinationProvider duplicate protectionApproval before production
Changes a time entry's description, times, task, billable flag or adds tags.
time entry tags1
- List time entry tagsSource
Tags used on time entries in the workspace.
user groups1
- List user groupsSource
User groups (teams) in the workspace with member IDs.
view tasks1
- List view tasksSource
Tasks visible in a view, with the view's filters applied.
views1
- List viewsSource
Views on the workspace (Everything level), a space, a folder or a list.
workspaces1
- List workspacesSource
Workspaces (teams) the token can access, with members.
Access and limits
- Authentication
- Personal API token
- Plans and access
- All plans; time tracking, goals and some custom fields depend on plan. Personal tokens act as the user who generated them.
- Test environment
- Use a free ClickUp workspace for testing.
- Rate limits
- 100 requests per minute per token on Free Forever to Business; higher on Enterprise. HTTP 429.
- Pagination
- Zero-based page numbers with 100 tasks per page and a last_page flag; Docs use next_cursor.
- Provider events
- Workspace webhooks with X-Signature HMAC-SHA256. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Task comments return the latest page provided by ClickUp; older comments are not paginated.
- Task creation has no idempotency key; uncertain creates are not repeated automatically.
- Task search takes one value per filter (one status, assignee, list, space or tag) because Nexra sends single-valued query parameters.
- Docs are read-only (ClickUp Docs API v3); page editing is not implemented.
- Task file attachments need multipart uploads, which the recipe runtime does not send; attachments are not implemented.
- Intentionally excluded: deleting spaces, folders, lists, tasks, comments, checklists, time entries, goals, key results, tags and views; merging tasks; starting or stopping timers; inviting or removing users and guests; webhooks.
Developer reference
- Create the ClickUp credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose ClickUp, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/clickup and the Connections API.