Want to create an app that integrates with ClickUp? Give your users the ability to sign in using OAuth 2.0!

What you'll need

  • Our API is avaialble 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.

Create an App

The first step for using OAuth 2 is to create an app in your Workspace.

Note: You must be a Workspace owner or admin to manage Integration settings.

Integrations settings page with the ClickUp API option highlighted
  1. Click your Workspace avatar in the lower-left corner

  2. Select Integrations

  3. Click ClickUp API

  4. Enter your app's name and a redirect URL(s)

  5. Click Create App

  6. On the next screen, you'll see a Client ID and Client Secret have been generated

  7. Use the Client ID and Client Secret in your app to create an OAuth 2 authentication flow

Create an App modal with an example Client ID and Client Secret

Update your Direct URLs

Have a new redirect URL? You can update these settings in your ClickUp Workspace at any time.

  1. Click your Workspace avatar in the lower-left corner

  2. Select Integrations

  3. Click ClickUp API

  4. Expand the App to show its details

  5. 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.

  1. Click your Workspace avatar in the lower-left corner

  2. Select Integrations

  3. Click ClickUp API

  4. Expand the App to show its details

  5. Click Show to view your current Client Secret

  6. Click Regenerate to immediately create a new Client Secret

  7. Update your App to use the new Client Secret


Want to learn more?

Did this answer your question?