Skip to main content

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 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

1

Navigate to connections

Go to Dashboard > Projects > [Your Project] > Connections.
2

Connect ClickUp

Click Connect ClickUp. This opens the OAuth flow managed by Nango.
3

Authorize access

Grant access to your ClickUp workspace.
4

Configure list mapping

After connecting, select the ClickUp space and list where tasks should be created.

​
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:
FieldContent
TitleConcise description of the failure
DescriptionDetailed reproduction steps with Markdown formatting
Error detailsStack traces, error messages, assertion failures
Tagsbugzy-automated, test case ID
PriorityBased 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.