Search

Create your own app with the ClickUp API

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

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.

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:
  1. In the upper-right corner, click your personal avatar.
  2. Select Settings. 
  3. In the sidebar, click ClickUp API.
  4. Click + Create an App.
  5. Enter your app's name and a redirect URL(s).
    If you're not sure what to use for your redirect URL, check out this guide on OAuth's website.
  6. Click Create App.
  7. On the next screen, you'll see a Client ID and Client Secret have been generated.
  8. Use the Client ID and Client Secret in your app to create an OAuth 2 authentication flow.

Screenshot of the app' modal using OAuth2.

Update your redirect URLs

If you have a new redirect URL, you can update these settings in your ClickUp Workspace at any time:
  1. In the upper-right corner, click your personal avatar.
  2. Select Settings. 
  3. In the sidebar, click ClickUp API.
  4. Click an existing app to expand its details.
  5. Update the redirect URL.
  6. Click Save.

View or regenerate your client secret

To regenerate your client secret:
  1. In the upper-right corner, click your personal avatar.
  2. Select Settings. 
  3. In the sidebar, click ClickUp API.
  4. Click an existing app to expand its details.
  5. Click Show to view your current Client Secret.
  6. Click Regenerate to create a new Client Secret.
  7. 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.
Screenshot of someone selecting which Workspaces to authorize with OAuth2.

Was this article helpful?