- Documentation
ClickUp integration
Manage tasks, lists, and comments and react to workspace events on behalf of your clients' ClickUp workspaces.
What it does
The ClickUp integration lets your agency drive tasks, lists, and comments inside your clients' ClickUp workspaces without leaving TaskJuice. Connect a workspace once and your workflows can create and update tasks against the ClickUp v2 REST API, list teams and folders, post comments back into the activity stream, and react in real time when tasks or lists change in the workspace.
Connect a ClickUp account
- Open your workspace in TaskJuice and navigate to Connections.
- Choose ClickUp and click Connect.
- Sign in to the ClickUp account that owns the workspace you want to wire up and approve the requested access.
- TaskJuice returns you to the workspace with the connection ready to use in any workflow.
To revoke access, open your ClickUp profile, navigate to Apps, and remove the TaskJuice authorization. See the ClickUp authentication guide for the full grant flow.
Triggers
clickup/task-createdfires when a new task is created in the workspace (taskCreatedevent). The activation payload carries thewebhook_id, the originatingtask_id, and the ClickUphistory_itemsdescribing the change.clickup/task-updatedfires when a task is updated in the workspace (taskUpdatedevent). Use it to react to status, priority, assignee, or due-date changes.clickup/task-deletedfires when a task is removed (taskDeletedevent).clickup/list-createdfires when a new list is created (listCreatedevent).
Every inbound POST is authenticated by recomputing HMAC-SHA256 over the raw request body using the secret returned when the workspace webhook was created, and comparing the hex digest against the value ClickUp sends in the X-Signature header. Activations that fail the check are rejected before they reach your workflow.
Actions
clickup/create-taskcreates a task inside a target list with title, description, status, priority, assignees, tags, and due date.clickup/get-taskretrieves a single task by ID, with optional support for custom task IDs scoped to a team.clickup/update-taskupdates an existing task's title, description, status, priority, due date, or archived flag.clickup/delete-taskremoves a task from the workspace.clickup/create-listcreates a new list inside a target folder.clickup/get-teamslists the authorized teams (workspaces) available to the connected user.clickup/create-task-commentposts a comment to a task, with optional assignee and notify-all flag.
Known limitations
- The ClickUp API enforces a per-token rate limit. When a
429status is returned, TaskJuice surfaces it as a retryable error so the workflow can back off and retry. - Webhooks are scoped to a single workspace at creation time. To listen on multiple workspaces, create one webhook (and one connection) per workspace.
- The TaskJuice integration targets ClickUp API v2. Fields surfaced only on private or beta endpoints are not exposed.