Overview

Pre-built tooling

Pre-built integrations

No pre-built integration yet (time to contribute: <48h)

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree ClickUp account is sufficient for development.
Paid test account✅ Not requiredFree ClickUp account is sufficient for testing.
Partnership✅ Not required
App review✅ Not requiredNo review process for OAuth apps.
Security audit✅ Not required

Setup guide

1

Create a ClickUp account

  1. If you don’t already have a ClickUp account, go to ClickUp’s signup page and create one.
  2. Sign in to your ClickUp account.
2

Create a new OAuth app

  1. In the upper-right corner, click on your avatar.
  2. Select Settings from the dropdown menu.
  3. In the sidebar, click on Apps.
  4. Click the Create new app button.

Note: Only Workspace owners or admins can create OAuth apps.

3

Configure your OAuth application

Fill in the required fields:

  1. App name: Enter a name for your application.
  2. Redirect URL: Enter https://api.nango.dev/oauth/callback

This is the URL where ClickUp will redirect users after they authorize your application.

4

Obtain your OAuth credentials

After creating your app, you’ll receive:

  • Client ID: A unique identifier for your application
  • Client Secret: A secret key for your application

Make sure to store these securely, especially the Client Secret, as you’ll need them when configuring your integration in Nango.

5

Configure your integration in Nango

When setting up your ClickUp integration in Nango:

  • Use your Client ID and Client Secret from the previous step
  • For the authorization URL, use: https://app.clickup.com/api
  • For the token URL, use: https://api.clickup.com/api/v2/oauth/token

Note: ClickUp does not use scopes in their OAuth implementation, so you can leave the scope field empty.

6

Understand the OAuth flow

The ClickUp OAuth flow follows these steps:

  1. Users are redirected to ClickUp’s authorization page: https://app.clickup.com/api?client_id={client_id}&redirect_uri={redirect_uri}
  2. Users log in to ClickUp and select which Workspaces to authorize for your app
  3. After authorization, users are redirected back to your redirect URL with an authorization code
  4. Your application exchanges this code for an access token using the token endpoint
7

Test the OAuth flow

  1. After configuring your integration in Nango, test the OAuth flow to ensure it works correctly.
  2. The authorization flow will redirect users to ClickUp where they can approve access to their Workspaces.
  3. After approval, users will be redirected back to your application with an authorization code.
  4. This code will be exchanged for an access token that can be used to make API requests.
8

Next

Follow the Quickstart.

Need help getting started? Get help in the community.

API gotchas

  • ClickUp does not use scopes in their OAuth implementation, so you can leave the scope field empty when configuring your integration.

  • Users can authorize one or more Workspaces for your application. Use the Get Authorized Teams (Workspaces) endpoint to see which Workspaces are authorized.

Contribute API gotchas by editing this page