Want to create an app that integrates with ClickUp? Give your users the ability to sign in using OAuth 2.0!
Be sure to also check out our API documentation!
What you'll need
- The ClickUp API is available on all ClickUp plans.
- A Workspace owner or admin will need to create an app in your ClickUp Workspace.
OAuth 2 flow
When you want to develop an application that others can use, you must use an OAuth2 authentication flow.
With OAuth 2 everyone that uses your app gets assigned an individualized token. Each user can only access the content available to their individual ClickUp user account.
Tip: If you are unfamiliar with OAuth2, Digital Ocean has put together a great guide that should get you started. We also recommend checking out OAuth's website for additional details.
Create an app
The first step for using OAuth 2 is to create an app in your Workspace.
You must be a Workspace owner or admin to manage integration settings. To do so:
- In the lower-left corner, click your Workspace avatar.
- Select Integrations.
- Click ClickUp API.
- Enter your app's name and a redirect URL(s).
- Tip: Not sure what to use for your redirect URL? Check out this guide on OAuth's website.
- Click Create App.
- On the next screen, you'll see a Client ID and Client Secret have been generated.
- Use the Client ID and Client Secret in your app to create an OAuth 2 authentication flow.
Update your redirect URLs
Have a new redirect URL? You can update these settings in your ClickUp Workspace at any time.
- In the lower-left corner, click your Workspace avatar.
- Select Integrations.
- Click ClickUp API.
- Expand the App to show its details.
- Update your app:
- Add or update the redirect URLs.
- Click Save.
View or regenerate your client secret
Want to regenerate your Client Secret? You can do so at any time.
- Click your Workspace avatar in the lower-left corner
- Select Integrations
- Click ClickUp API
- Expand the App to show its details
- Click Show to view your current Client Secret
- Click Regenerate to immediately create a new Client Secret
- Update your App to use the new Client Secret
Authorization token types
Tokens permit you to make API calls and integrate with other applications. You can also use apps like Make to create integrations without writing code. Tokens are specific to your ClickUp user account.
Anyone with a ClickUp account can generate a personal token. Personal tokens permit access to every Workspace your account has created or joined. Your personal token gives you the same access that you have through a web browser.
If you use OAuth2, you can choose to authorize access to specific Workspaces when you first authenticate or when you re-authenticate later.

Aggiornato