Linear Integration

Two-way sync with Linear issues. Threads become issues with full context, and status stays in sync across both tools.

Overview

When a Yocoolab thread is sent to Linear, an issue is created with Markdown descriptions including deployment URLs, selectors, PR links, and viewport details. Resolving a thread in Yocoolab transitions the Linear issue to Done, and completing an issue in Linear auto-resolves the Yocoolab thread.

Prerequisites

  • A Linear workspace
  • Permission to create API keys in Linear settings

Setup Steps

  1. 1

    Create a Linear API key

    In Linear, go to Settings → API → Personal API Keys and click Create Key.

    Copy the key — you won't be able to see it again.

  2. 2

    Open Yocoolab integration settings

    In the admin dashboard, go to Settings → Integrations → Linear.

  3. 3

    Enter your Linear API key

    Paste the API key and click Save. Yocoolab validates the key by querying the Linear GraphQL API.

  4. 4

    Test the connection

    Click Test Connection. You should see your Linear user name and workspace.

  5. 5

    Map repositories to Linear teams

    For each Yocoolab repository, select a Linear team. When a thread from that repo is sent to Linear, the issue is created in the mapped team.

  6. 6

    Set up a webhook (optional)

    For two-way sync, configure a Linear webhook:

    In Linear, go to Settings → API → Webhooks and create a webhook pointing to:

    https://api.yocoolab.com/api/v1/linear/webhook

    Select the Issues resource with Update and Remove actions.

Verification

Create a test thread and send it to Linear. The issue should appear in the mapped team with a Markdown description containing the thread context, screenshot link, and a deep link back to the live app.

API Reference

MethodEndpointDescription
POST/api/v1/linear/configSave Linear API key
GET/api/v1/linear/configGet current Linear configuration status
GET/api/v1/linear/testTest stored Linear credentials
GET/api/v1/linear/teamsList accessible Linear teams
POST/api/v1/linear/mappingsCreate or update a repo-to-team mapping
GET/api/v1/linear/mappingsList all repo-to-team mappings
DELETE/api/v1/linear/configDisconnect Linear integration

Troubleshooting

Warning

Invalid API key — Linear API keys are long alphanumeric strings starting with lin_api_. Make sure you copied the full key.

Note

Team not found — The API key must belong to a user who is a member of the team you want to map. Check your Linear team membership.

Ready to start reviewing on the real product?

Install the free Chrome Extension, connect your tools, and start shipping faster — in under a minute.

Install Extension — FreeOr sign in to the dashboard →

No seat fees. Every team member is free — designers, developers, PMs, stakeholders.