Skip to main content
Version: v2 (current)

ClickUp Integration with PanDev Metrics

import IdealImage from "@theme/IdealImage"; import Head from "@docusaurus/Head";

TL;DR. To connect ClickUp you need two values: a Personal API Token and your Team ID. Generate the token in ClickUp, copy the Team ID from the address bar, and paste both into Settings → Integrations → ClickUp. Audience: admin.

Before you begin​

  • PanDev Metrics is up and running (Cloud workspace or on-prem instance)
  • Admin access to your PanDev Metrics tenant
  • A ClickUp account with access to the workspace you want to track

Step 1 — Create a Personal API Token​

  1. Sign in to ClickUp.
  2. Click your avatar in the top-right corner → Settings.
  3. In the left menu, open Apps.
  4. Under API Token, click Generate.
  5. Copy the token — it starts with pk_….

:::warning Keep the token private The Personal API Token grants the same access as your ClickUp account. Store it in a secrets manager. :::

Step 2 — Get your Team ID​

Your ClickUp Team ID is the number in the address bar right after the domain:

https://app.clickup.com/{teamId}

Open ClickUp in a browser and copy the number that follows https://app.clickup.com/.

Step 3 — Connect ClickUp in PanDev Metrics​

  1. Open PanDev Metrics and go to Settings → Integrations → ClickUp.
  2. Fill in the form:
FieldValue
API TokenThe pk_… value from Step 1
Team IDThe number from Step 2
  1. Save the integration.

Verify​

Open a dashboard with a task-tracker widget and confirm that ClickUp tasks appear next to commits and their statuses match ClickUp.

To link a commit or pull request to a ClickUp task, put the task ID with the CU- prefix in the branch name, commit message, or PR title — for example feature/CU-abc1d2 - description.

Troubleshooting​

Connection fails with "401 Unauthorized"

The API token is wrong or was regenerated. Open ClickUp → Settings → Apps, generate a fresh token, and paste it into PanDev Metrics.

No tasks appear

The Team ID is wrong. Reopen ClickUp in a browser and copy the number right after https://app.clickup.com/.

Next steps​