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.Create the Linear webhook
In Linear, create an issue webhook that sends requests to
https://zudo.so/api/webhooks/linear.Subscribe to issue create and update events
Zudo only processes Linear webhook actions for issue create and update.
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.
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.
https://api.linear.app/graphql.
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 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
https://zudo.so/api/webhooks/linear. - 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.