Skip to main content

Authorization

Follow this guide to create a new ClickUp credential that will allow Nexla to authenticate to and exchange data with your ClickUp account.
click_up_api_auth.png

ClickUp

Prerequisites​

The ClickUp connector authenticates to the ClickUp API v2 using a personal API token. This token authorizes Nexla to read and write data on behalf of your ClickUp user account, so it carries the same access permissions as the account that generated it.

Before creating a credential in Nexla, ensure you have the following:

A ClickUp Account with API Access​

The user generating the token must be a member or limited member with full edit permissions in the ClickUp Workspace. Limited members with view-only permissions cannot generate or use personal API tokens.

A ClickUp Personal API Token​

A personal API token is a string that begins with pk_ and does not expire. To generate your token:

  1. Sign in to ClickUp, click your avatar in the upper-right corner, and select Settings.

  2. In the left sidebar, click Apps.

  3. Under the API Token section, click Generate (or Regenerate if a token already exists).

  4. Click Copy to copy the personal token to your clipboard for use in the steps below.

Keep your token secure

A personal API token grants access to all resources your ClickUp account can reach. Store it securely, do not share it, and regenerate it immediately if you suspect it has been exposed. Regenerating a token invalidates the previous one.

For complete details about ClickUp authentication, including the difference between personal tokens and OAuth apps, refer to the official ClickUp API Authentication documentation.

Create a ClickUp Credential​

  • To create a new ClickUp credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

ClickUp uses API key authentication. Nexla sends your personal API token in the Authorization header of every request to the ClickUp API and validates the credential against the https://api.clickup.com/api/v2/user endpoint when you save it.

  1. Enter your ClickUp personal API token in the API Key field. This is the value beginning with pk_ that you copied from Settings > Apps > API Token in ClickUp.

    Enter only the raw token value (for example, pk_12345678_ABCDEF...). Do not add a Bearer prefix—ClickUp personal tokens are sent as a raw string, and Nexla applies the Authorization header automatically.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.