ClickUp - Nango Docs

🚀 Quickstart

Connect to ClickUp with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> ClickUp. Nango doesn’t provide a test OAuth app for ClickUp yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID and secret in the integration settings in Nango.

Authorize ClickUp

Go to Connections -> Add Test Connection -> Authorize, then log in to ClickUp. Later, you’ll let your users do the same directly from your app.

Call the ClickUp API

Let’s make your first request to the ClickUp API (fetch the profile of the currently signed-in user). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/api/v2/user" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/api/v2/user',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(JSON.stringify(res.data, null, 2));

Or fetch credentials dynamically via the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 ClickUp Integration Guides

Nango maintained guides for common use cases.

How to register your own ClickUp OAuth app
Register an OAuth app with ClickUp and obtain credentials to connect it to Nango

Official docs: ClickUp API docs

🧩 Pre-built syncs & actions for ClickUp

Enable them in your dashboard. Extend and customize to fit your needs.

Comments

Function name	Description	Type	Source code
`create-comment`	Create a comment in ClickUp on a task or list	Action	🔗 Github
`delete-comment`	Delete a comment in ClickUp	Action	🔗 Github
`list-comments`	List comments from ClickUp	Action	🔗 Github
`update-comment`	Update a comment in ClickUp.	Action	🔗 Github

Folders

Function name	Description	Type	Source code
`create-folder`	Create a folder in ClickUp.	Action	🔗 Github
`delete-folder`	Delete a folder in ClickUp	Action	🔗 Github
`get-folder`	Retrieve a single folder from ClickUp.	Action	🔗 Github
`update-folder`	Update a folder in ClickUp	Action	🔗 Github

Goals

Function name	Description	Type	Source code
`create-goal`	Create a goal in ClickUp	Action	🔗 Github
`delete-goal`	Delete a goal in ClickUp	Action	🔗 Github
`get-goal`	Retrieve a single goal from ClickUp	Action	🔗 Github
`list-goals`	List goals from ClickUp	Action	🔗 Github
`update-goal`	Update a goal in ClickUp	Action	🔗 Github

Lists

Function name	Description	Type	Source code
`create-list`	Create a list in ClickUp	Action	🔗 Github
`delete-list`	Delete a list in ClickUp. This is a permanent delete and all tasks inside the list are also deleted.	Action	🔗 Github
`get-list`	Retrieve a single list from ClickUp.	Action	🔗 Github
`list-lists`	List lists from ClickUp	Action	🔗 Github
`update-list`	Update a list in ClickUp.	Action	🔗 Github

Spaces

Function name	Description	Type	Source code
`create-space`	Create a space in ClickUp.	Action	🔗 Github
`delete-space`	Delete a space in ClickUp	Action	🔗 Github
`get-space`	Retrieve a single space from ClickUp	Action	🔗 Github
`list-spaces`	List spaces from ClickUp	Action	🔗 Github
`update-space`	Update a space in ClickUp.	Action	🔗 Github

Tasks

Function name	Description	Type	Source code
`create-task`	Create a task in ClickUp	Action	🔗 Github
`delete-task`	Delete a task in ClickUp	Action	🔗 Github
`get-task`	Retrieve a single task from ClickUp.	Action	🔗 Github
`list-tasks`	List tasks from a ClickUp list with optional filtering and pagination	Action	🔗 Github
`update-task`	Update a task in ClickUp	Action	🔗 Github

Time Tracking

Function name	Description	Type	Source code
`create-time-entry`	Create a time entry in ClickUp	Action	🔗 Github
`delete-time-entry`	Delete a time entry in ClickUp	Action	🔗 Github
`get-time-entry`	Retrieve a single time entry from ClickUp	Action	🔗 Github
`list-time-entries`	List time entries from ClickUp	Action	🔗 Github
`update-time-entry`	Update a time entry in ClickUp.	Action	🔗 Github

Users

Function name	Description	Type	Source code
`get-user`	Retrieve a single workspace member from ClickUp.	Action	🔗 Github
`list-users`	List workspace members from ClickUp	Action	🔗 Github

Others

Function name	Description	Type	Source code
`list-folders`	List folders from a ClickUp space	Action	🔗 Github
`comments`	Sync comments from ClickUp	Sync	🔗 Github
`folders`	Sync folders from ClickUp.	Sync	🔗 Github
`goals`	Sync goals from ClickUp	Sync	🔗 Github
`lists`	Sync lists from ClickUp	Sync	🔗 Github
`spaces`	Sync spaces from ClickUp.	Sync	🔗 Github
`tasks`	Sync tasks from ClickUp.	Sync	🔗 Github
`time-entries`	Sync time entries from ClickUp	Sync	🔗 Github
`users`	Sync workspace members from ClickUp	Sync	🔗 Github

Documentation Index

​🚀 Quickstart

​📚 ClickUp Integration Guides

​🧩 Pre-built syncs & actions for ClickUp

​Comments

​Folders

​Goals

​Lists

​Spaces

​Tasks

​Time Tracking

​Users

​Others