> ## Documentation Index
> Fetch the complete documentation index at: https://www.bugzy.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickUp

> Connect ClickUp for automatic task creation when Bugzy triages product failures.

ClickUp integration enables automatic task creation for failures that Bugzy triages as product bugs. When tests fail and Bugzy determines the failure is a genuine product issue, it creates a task in your ClickUp workspace with full reproduction details.

## What ClickUp enables

* **Automatic task creation** — Triaged product failures are filed as ClickUp tasks without manual intervention
* **Duplicate detection** — Bugzy searches existing tasks before creating new ones to avoid duplicates
* **Rich bug reports** — Tasks include reproduction steps, error details, screenshots, and environment info
* **Priority mapping** — Task priority is set based on failure severity and impact

## Setup

<Steps>
  <Step title="Navigate to connections">
    Go to **Dashboard > Projects > \[Your Project] > Connections**.
  </Step>

  <Step title="Connect ClickUp">
    Click **Connect ClickUp**. This opens the OAuth flow managed by Nango.
  </Step>

  <Step title="Authorize access">
    Grant access to your ClickUp workspace.
  </Step>

  <Step title="Configure list mapping">
    After connecting, select the ClickUp space and list where tasks should be created.
  </Step>
</Steps>

## How task creation works

1. **Test execution** — Bugzy runs tests and collects results
2. **Triage** — Bugzy analyzes failures, categorizing each as: product bug, test issue, or environment problem
3. **Duplicate check** — For product bugs, the agent searches existing ClickUp tasks to avoid duplicates
4. **Create task** — If no duplicate exists, a task is created with structured details
5. **Notify team** — If Slack/Teams is connected, the team is notified about the new task

### Task contents

Each filed ClickUp task includes:

| Field         | Content                                              |
| ------------- | ---------------------------------------------------- |
| Title         | Concise description of the failure                   |
| Description   | Detailed reproduction steps with Markdown formatting |
| Error details | Stack traces, error messages, assertion failures     |
| Tags          | `bugzy-automated`, test case ID                      |
| Priority      | Based on failure severity and impact                 |

## Troubleshooting

**Tasks not being created** — Verify the ClickUp connection is active and the list mapping is configured. Check that the connected user has permission to create tasks in the target list.

**Duplicate tasks being filed** — The agent uses title and error signature matching for duplicate detection. If you see duplicates, ensure the list mapping is correct.

**"Forbidden" errors** — The OAuth token may lack required permissions. Disconnect and reconnect ClickUp from the project connections page to re-authorize.