Integration with ClickUp

This integration is available starting with Allure TestOps version 25.3.1.

Integration with ClickUp allows you to:

• link Allure TestOps entities (test cases, launches, test results, defects, mutes) with ClickUp issues;
• create ClickUp issues directly from the defect view in Allure TestOps (see Linking defects to issues for more details).

Unlike other integrations, ClickUp does not support issue search by ID.
When linking Allure TestOps entities to ClickUp issues, you can only search for issues by their names.

Configuring the integration

To configure the integration in Allure TestOps, you need to have access to the sections:

• Administration — requires instance administrator permissions;
• Settings of a specific project — requires the project owner role.

To configure integration with ClickUp:

1. Create an API token in ClickUp.

2. Find out your project and team IDs in ClickUp.

3. At the Allure TestOps instance level, add the integration with ClickUp by providing:

   • integration name;
   • ClickUp URL;
   • ClickUp API URL.

4. At the instance or project level in Allure TestOps, enable the added integration for a project by providing the ClickUp project ID, team ID, and created API token.

1. Create API token in ClickUp

1. Sign in to your ClickUp instance.

2. In the upper-right corner, click your avatar and select Settings.

3. In the left sidebar, click Apps.

4. Under API Token, click Generate.

5. In the window that opens, enter your ClickUp account password and click Confirm Password.

6. Click Copy to copy the token into clipboard.

   Save the token in a secure place. You’ll need it to enable the integration in the Allure TestOps project.

2. Find out project and team IDs in ClickUp

1. In ClickUp, open the project for which you configure the integration with Allure TestOps.

2. In the left sidebar, next to the project name, click ⋯ → Copy link.

   You’ll get a URL like https://<your ClickUp domain>/<team ID>/v/li/<project ID>. For example: https://app.clickup.com/123321/v/li/567765.

3. Save the values of <team ID> and <project ID> in a secure place.

   You’ll need them to enable the integration in the Allure TestOps project.

3. Add ClickUp integration in Allure TestOps

1. Go to your Allure TestOps instance.

2. Go to Administration → Integrations.

3. In the upper-right corner, click + Add integration.

4. From the list of available integrations, select ClickUp.

5. Fill in the fields:

   • Name — a name to help you recognize the integration, for example, ClickUp Production.

   • Endpoint — the base URL of your ClickUp instance:

     • for cloud versions of ClickUp, use https://app.clickup.com;
     • for ClickUp Enterprise, use the URL of your ClickUp instance.

   • Endpoint for API calls — the URL of ClickUp API:

     • for all cloud versions of ClickUp, use https://api.clickup.com/api;
     • for ClickUp Enterprise, use ⟨URL⟩/api, where ⟨URL⟩ is the URL of your ClickUp instance.

6. Click Add integration.

4. Enable integration for Allure TestOps project

To enable integration in the specific Allure TestOps project, use one of the two methods below: