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

# Linear

> Link engineering issues to customer requests and track resolution time.

The Linear integration connects engineering work to customer impact. Link Linear issues to requests in Zudo to track what's being built, for whom, and how long it takes to ship.

## Connect

Linear is a manual connection in Zudo. Before you add it in the app, create a Linear issue webhook and a Linear personal API key.

<Steps>
  <Step title="Create the Linear webhook">
    In Linear, create an issue webhook that sends requests to <code>[https://zudo.so/api/webhooks/linear](https://zudo.so/api/webhooks/linear)</code>.
  </Step>

  <Step title="Subscribe to issue create and update events">
    Zudo only processes Linear webhook actions for issue <strong>create</strong> and <strong>update</strong>.
  </Step>

  <Step title="Copy the webhook ID">
    After Linear creates the webhook, copy the webhook ID. Zudo stores that ID on the connection and uses it to match
    incoming webhook events.
  </Step>

  <Step title="Add the connection in Zudo">
    Go to **Settings → Connections**, click **Add Connection**, select **Linear**, and enter the default API URL, your
    personal API key, and the webhook ID from Linear.
  </Step>

  <Step title="Run the first sync">
    Create the connection, then use **Sync Now** any time you want to pull the latest issues.
  </Step>
</Steps>

The default API URL is <code>[https://api.linear.app/graphql](https://api.linear.app/graphql)</code>.

## What syncs

* **Issues** — imported from Linear with title, description, and ID
* **Issue state** — Zudo updates issue state from the initial sync and from subsequent Linear webhook events
* **Resolution time** — when an issue closes, Zudo records how long it was open

## Impact on health scoring

Issue resolution time is one of the five factors in the [health score](/accounts/health-scoring). Accounts linked to slow-resolving issues score lower in that dimension.

## Linking issues to requests

Open any request and use the issue link option to search for and attach a Linear issue. The issue's state becomes visible on the request and on any linked account.

You can also go the other direction — open a Linear issue in Zudo and create a new request from it. This is useful when engineering flags something and you want to track which customers are affected.

## Troubleshooting

* If new Linear changes are not showing up, confirm the webhook still points to <code>[https://zudo.so/api/webhooks/linear](https://zudo.so/api/webhooks/linear)</code>.
* Make sure the webhook ID saved in Zudo matches the webhook ID in Linear.
* If the webhook is correct but the issue list looks stale, run **Sync Now** from the connection card.