ClickUp integration

Overview

ClickUp is an all-in-one work-management platform – Spaces, Folders, Lists, Tasks, with custom fields and dependencies. The Automize ClickUp connector covers the task lifecycle and the hierarchy navigation needed to find / create the right work items in automation.

• Regions: ClickUp is a single global platform – api.clickup.com. No region selector.
• Plans: Free Forever, Unlimited, Business, Business Plus, Enterprise – all expose the API. Some fields (custom fields, time tracking) need Unlimited or above.

Setting up the connection

Auth type: OAuth 2.0 (Authorization Code).

1. In ClickUp, click your avatar → Apps → Create New App.
2. Set Redirect URL to the one in the Automize ClickUp connector dialog.
3. Copy Client ID + Client Secret.
4. In Automize, open Settings → Connectors → ClickUp → Add connection. Paste credentials, click Connect with ClickUp, pick workspace, approve.

Find your credentials at https://app.clickup.com/settings/apps.

Rate limits

ClickUp enforces 100 requests/min per token (Free/Unlimited) or 1,000/min (Business+). The connector retries 429 with the Retry-After header. For large workspaces, scope list calls to a specific List or Folder rather than walking the whole tree.

Data model

Hierarchy:

    Workspace ─┬─ Spaces ─┬─ Folders ─── Lists ─── Tasks
               │          └─ Lists (folderless) ─── Tasks
               └─ Members
    Tasks ─┬─ Sub-tasks
           ├─ Comments
           ├─ Attachments
           ├─ Custom Fields
           ├─ Time Entries
           └─ Dependencies

Spaces are the top-level container; tasks always live in a List
(directly or via a Folder).

Available operations

17 operations available. Click any row to jump to its detail.

Operations

Create comment

Add a comment to a ClickUp task.

Tips

• task_id + comment_text. notify_all=true sends notifications.

Create task

Create a new task in a ClickUp list.

Tips

• list_id + name.
• assignees: array of user IDs. status: matching the List's workflow.
• due_date: epoch ms (NOT seconds).

Create time entry

Track time on a ClickUp task.

Tips

• task_id + duration (ms) + start time. billable=true for chargeable time.

Delete task

Delete a ClickUp task.

Tips

• Moves to Trash. Restorable for 30 days via UI.

Get space

Get ClickUp space details.

Tips

• Returns space + features (which ClickApps are enabled).

Get task

Get ClickUp task details by ID.

Tips

• task_id is the alphanumeric short ID (e.g. 86c12abcd). Get it from any task URL.

List task comments

List comments on a ClickUp task.

Tips

• task_id. Returns ordered comments + replies.

List folderless lists

List lists directly in a ClickUp space (no folder).

List folders

List folders in a ClickUp space.

Tips

• space_id required. Returns folders in that space.

List lists

List lists in a ClickUp folder.

Tips

• folder_id OR space_id (folderless). Returns lists.

List members

List members of a ClickUp list.

Tips

• list_id. Returns users who can see the List.

List spaces

List spaces in a ClickUp workspace.

Tips

• team_id (workspace ID) required. Returns spaces in that workspace.

List tags

List tags in a ClickUp space.

List tasks

List tasks in a ClickUp list.

Tips

• list_id required. Filter by status, assignees, due_date_gt/lt, archived.
• Returns up to 100 tasks per page. Page via the page query param.

List time entries

List time tracked on a ClickUp task.

Tips

• team_id + date range (start_date, end_date in epoch ms). Filter by assignee.

List workspaces

List all ClickUp workspaces (teams).

No input parameters.

Update task

Update a ClickUp task.

Tips

• PATCH-style on name, description, status, priority, due_date, assignees.

FAQ

Custom task IDs vs default – which?

Default uses internal IDs. Some workspaces enable Custom Task IDs (e.g. PROJ-123). Both work – pass either to Get Task. For Custom IDs, the connector handles the format detection.

Due date format – epoch seconds or ms?

Milliseconds. Multiplying seconds by 1000 if you have a unix timestamp from another system. Forgetting this puts due_date at 1970.

Why does Create Task ignore my status?

Status must match exactly the status names defined for that List's workflow. Case-sensitive. Use Get List → statuses to verify.

Folderless lists – how?

Spaces can contain folders OR lists directly. Use List Lists with space_id to get folderless lists.

Related connectors

• Asana
• Monday
• Jira
• Notion