Clickup
Overview
Pre-built tooling
Pre-built integrations
No pre-built integration yet (time to contribute: <48h)
Access requirements
Pre-Requisites | Status | Comment |
---|---|---|
Paid dev account | ✅ Not required | Free ClickUp account is sufficient for development. |
Paid test account | ✅ Not required | Free ClickUp account is sufficient for testing. |
Partnership | ✅ Not required | |
App review | ✅ Not required | No review process for OAuth apps. |
Security audit | ✅ Not required |
Setup guide
Create a ClickUp account
- If you don’t already have a ClickUp account, go to ClickUp’s signup page and create one.
- Sign in to your ClickUp account.
Create a new OAuth app
- In the upper-right corner, click on your avatar.
- Select Settings from the dropdown menu.
- In the sidebar, click on Apps.
- Click the Create new app button.
Note: Only Workspace owners or admins can create OAuth apps.
Configure your OAuth application
Fill in the required fields:
- App name: Enter a name for your application.
- Redirect URL: Enter
https://api.nango.dev/oauth/callback
This is the URL where ClickUp will redirect users after they authorize your application.
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.
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.
Understand the OAuth flow
The ClickUp OAuth flow follows these steps:
- Users are redirected to ClickUp’s authorization page:
https://app.clickup.com/api?client_id={client_id}&redirect_uri={redirect_uri}
- Users log in to ClickUp and select which Workspaces to authorize for your app
- After authorization, users are redirected back to your redirect URL with an authorization code
- Your application exchanges this code for an access token using the token endpoint
Test the OAuth flow
- After configuring your integration in Nango, test the OAuth flow to ensure it works correctly.
- The authorization flow will redirect users to ClickUp where they can approve access to their Workspaces.
- After approval, users will be redirected back to your application with an authorization code.
- This code will be exchanged for an access token that can be used to make API requests.
Next
Follow the Quickstart.
Useful links
- ClickUp API Documentation
- ClickUp API Reference
- OAuth Flow
- OAuth Endpoints
- API v2 and v3 Terminology
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.