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

# Linear Tickets

> Connect Linear and choose where Autosana creates tickets

<Frame>
  <img src="https://mintcdn.com/autosana/bZsCWJHQCPtm8HwE/images/linear-integration.png?fit=max&auto=format&n=bZsCWJHQCPtm8HwE&q=85&s=ac96802d4726a09b2ccfec62f7d83fb1" alt="Linear integration settings showing connection status and default triage team" width="2098" height="510" data-path="images/linear-integration.png" />
</Frame>

Connect Linear to create editable tickets from Autosana 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 Autosana workspace admin or owner to install and configure
Linear.

1. Go to **[Settings > Integrations > Linear](https://autosana.ai/settings?tab=integrations\&integration=linear)**
2. Click **Connect Linear**
3. Authorize Autosana 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.
</Note>

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

Autosana 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, Autosana 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 Autosana. The integration
settings show webhook health, the latest delivery, and whether reconnection is
required. Autosana 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

<Frame>
  <img src="https://mintcdn.com/autosana/uquJnR72Olxw90_4/images/linear-triage-issue.png?fit=max&auto=format&n=uquJnR72Olxw90_4&q=85&s=c2796f37db5106ce4d5ed7df4c0a02de" alt="Linear issue created from an Autosana issue group with its summary and evidence link" width="720" height="631" data-path="images/linear-triage-issue.png" />
</Frame>


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