TestOps logo
Try TestOps

ClickUp

This integration is available starting with Allure TestOps version 25.3.1.

ClickUp integration lets Allure TestOps link work items to test artifacts inside the ClickUp workspace your team already uses. It covers:

  • linking ClickUp tasks to test cases, launches, defects, and mutes;
  • using ClickUp task search from TestOps inside the configured workspace boundary;
  • creating ClickUp tasks from defect workflows in TestOps.

ClickUp does not support issue search by ID. When linking TestOps entities to ClickUp tasks, you can only search by task name within the configured list boundary.

Before you begin

  • A ClickUp personal API token.
  • The ClickUp team ID and at least one list ID that TestOps should search.
  • Permission to add global integrations in TestOps and to enable them in the target project.

1. Create the ClickUp API token

  1. In ClickUp, click your avatar in the upper-right corner and select Settings.
  2. In the left sidebar, click Apps.
  3. Under API Token, click Generate.
  4. Enter your ClickUp account password and click Confirm Password.
  5. Click Copy to copy the token. Save it in a secure location.

2. Find the ClickUp team ID and list ID

  1. In ClickUp, open the list that TestOps should search.

  2. In the left sidebar, click ⋯ next to the list name and select Copy link.

    ClickUp sidebar with the three-dot menu open on a list

    The copied URL has this shape:

    https://app.clickup.com/<team_id>/v/li/<list_id>

    For example, in https://app.clickup.com/12345/v/li/67890:

    • 12345 is the team ID;
    • 67890 is the list ID.

  3. Save both values. If a TestOps project needs access to more than one ClickUp list, repeat this step for each list.

3. Add the global ClickUp integration

An instance administrator should:

  1. Open Administration → Integrations in TestOps.

  2. Click + Add integration.

  3. Select ClickUp.

  4. Fill in the fields:

    • Name — a stable name for the integration, for example ClickUp production.
    • Endpoint — the base URL of ClickUp:
      • cloud: https://app.clickup.com;
      • ClickUp Enterprise: the URL of your self-hosted instance.
    • Endpoint for API calls — the ClickUp API URL:
      • cloud: https://api.clickup.com/api;
      • ClickUp Enterprise: <your-instance-url>/api.

  5. Click Add integration.

4. Enable ClickUp in the TestOps project

  1. Go to Administration → Integrations.
  2. Find and open your ClickUp integration.
  3. Go to the Projects tab.
  4. Click + next to the search field.
  5. Select the target TestOps project.
  6. Under Lists, click + Add and enter the list ID from step 2. Repeat for each list the project should search.
  7. In the team_ID field, enter the team ID from step 2.
  8. In the Personal API Token field, paste the token from step 1.
  9. Click Test connection. If the credentials are correct, a "Connection established" message appears.
  10. Click Add integration.
  1. In TestOps, open the target project.
  2. Go to Settings → Integrations.
  3. Under Available integrations, find the ClickUp integration and click Add integration.
  4. Under Lists, click + Add and enter the list ID from step 2. Repeat for each list the project should search.
  5. In the Team ID field, enter the team ID from step 2.
  6. In the Personal API Token field, paste the token from step 1.
  7. Click Test connection. If the credentials are correct, a "Connection established" message appears.
  8. Save the project integration.

If a list is missing from the project integration, its tasks will not appear in the TestOps issue picker.

Verify the integration

Use both a link flow and a defect flow:

  1. Open a test case in TestOps and add an issue link.
  2. Confirm that the ClickUp picker can find tasks from the configured lists.
  3. Open a defect in TestOps and confirm that the ClickUp create-or-link workflow is available there as well.

Troubleshooting

The ClickUp picker cannot find the task you need

Check these points first:

  • the task belongs to one of the configured list IDs;
  • the ClickUp token has access to that list;
  • the task name matches the search text you enter.

The ClickUp task exists, but searching by ID does not work

This is expected. ClickUp search in TestOps is name-based only. Search by task name within the configured list boundary instead.

© Qameta Software Inc. All rights reserved.