Skip to main content

​
Generating a Personal API Token

Your Personal API Token grants the integration access to your ClickUp workspace data.

1

Sign in to ClickUp

Sign in to your ClickUp account using your credentials.

2

Navigate to Settings

From your ClickUp dashboard:

  • Click on your profile avatar.
  • Select Settings from the menu.
3

Access API Token Settings

In the Settings page:

  • Click on ClickUp API in the left sidebar (under the Integrations & ClickApps section).
  • You’ll find the API Token section on this page.
  • Click on Generate or Regenerate to create a new token.
4

Confirm Your Password

When clicking Regenerate, ClickUp will prompt you to confirm your account password before issuing a new token.

  • In the Enter your Password to generate API Token dialog, type your ClickUp account password.
  • Click Confirm Password to proceed.
5

Copy the API Token

Copy the generated API token immediately and store it securely. You can regenerate it at any time if needed.

​
Finding Your Workspace ID

Your default Workspace ID (also called Team ID) identifies which ClickUp workspace to access. This serves as the default workspace for API requests, but you can override it by passing other authorized workspace IDs in action input parameters.

1

Get Workspace ID from URL

The easiest way to find your workspace ID is from the ClickUp URL:

  • Sign in to your ClickUp account and navigate to any page in your workspace.
  • Look at the URL in your browser’s address bar (e.g., https://app.clickup.com/90161487323/inbox).
  • The workspace ID is the number immediately after app.clickup.com/ (e.g., “90161487323”).
  • Copy this number to use as your workspace ID.
2

Alternative Method Using API

You can also retrieve your workspace ID using the ClickUp API:

  • Make a GET request to https://api.clickup.com/api/v2/team with your Personal API Token in the Authorization header.
  • The response will contain your team/workspace ID in the teams array.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Personal API Token
  • Workspace ID (Team ID)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.