Use the ClickUp API

ClickUp's API endpoints allow you to instantly access your Workspace's data and build anything! Let your imagination run wild! Here are some suggestions to get you started:

If you're creating an application for others to use, follow the OAuth2 instructions. If you're using the API for personal use, use your personal API key.

Read through our full, dedicated API documentation.

Create a ClickUp app using OAuth2

To create a ClickUp app using OAuth2:

  1. In the upper-left corner, click your Workspace avatar.
  2. Select Settings.
  3. In the sidebar, click ClickUp API.
  4. In the upper right, click Create an App.
  5. Name the app and add a redirect URL.
  6. Click Create App.
  7. Your Client ID and Client Secret are automatically generated.
  8. You can now send people to the API URL with the required parameters to accept the authorization request.
  9. Acquire access token from the Get Access Token post request.

Learn more about using OAuth2 to create an app.

You may now use the OAuth2 access token in the Authorization header of your API requests.

Personal API Key

To find your token:

  1. In the upper-right corner, click your personal avatar.

  2. Click Settings.

  3. In the left sidebar, click Apps. 

  4. To create your API token, click Generate.

  5. To copy your API token to your clipboard, click Copy

Learn more about using your personal token.

You may now use the personal access token in the Authorization header of your API requests.

Was this article helpful?