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

# Linear Tickets

> Connect Linear and choose where BugRadar creates tickets

![Linear integration settings showing connection status and default triage team](https://mintcdn.com/BugRadar/bZsCWJHQCPtm8HwE/images/linear-integration.png?fit=max\&auto=format\&n=bZsCWJHQCPtm8HwE\&q=85\&s=ac96802d4726a09b2ccfec62f7d83fb1)

Connect Linear to create editable tickets from BugRadar issue groups. A grouped
ticket contains the issue summary, evidence links, and affected run context
instead of creating a separate Linear issue for every failed run.

## Connect Linear

You must be an BugRadar workspace admin or owner to install and configure
Linear.

1. Go to **[Settings > Integrations > Linear](https://usebugradar.com/settings?tab=integrations\&integration=linear)**
2. Click **Connect Linear**
3. Authorize BugRadar to access your Linear workspace
4. Select the default team for new tickets

> [!NOTE]
>
> Automatic Linear tickets remain unavailable until the default team is set and
> webhook delivery is verified. Reconnect Linear if the settings card reports
> that the installation needs new webhook permissions.

## Review and create tickets

Select **Create ticket** on an issue group or an individual flow-run issue. The
shared review dialog lets you choose Jira or Linear, select the destination
team, and edit the title and description before submitting.

BugRadar displays the Linear key after creation and keeps completed and failed
attempts in ticket history. One issue group can have only one current external
ticket. When an issue returns after its Linear ticket was completed, the dialog
offers a linked regression and reuses the previous team while it remains
available.

## Automatic tickets

Automatic creation is **Off** for new connections. Workspace admins can choose
one provider under **Settings > Integrations**: **Off**, **Jira**, or
**Linear**. During migration, an eligible existing Linear connection with a
configured default team preserves its prior automatic behavior.

When Linear is selected, BugRadar creates at most one current ticket for each
new critical issue group. Other issue groups remain available for manual review.
Issues marked **Don't show again** never create automatic tickets.

## Webhook health

Linear webhooks keep ticket status synchronized with BugRadar. The integration
settings show webhook health, the latest delivery, and whether reconnection is
required. BugRadar reconciles stale status in the background when a delivery is
missed.

If webhook health is degraded, manual creation may remain available, but
automatic Linear creation stays blocked until delivery is verified.

## Example issue

![Linear issue created from an BugRadar issue group with its summary and evidence link](https://mintcdn.com/BugRadar/uquJnR72Olxw90_4/images/linear-triage-issue.png?fit=max\&auto=format\&n=uquJnR72Olxw90_4\&q=85\&s=c2796f37db5106ce4d5ed7df4c0a02de)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.