Linear

Connecting Linear to Zero gives your team clear visibility into issue tracking right inside the CRM. It links customer data with project work, so every bug, feature request, or task is tied to the right account or contact.

With this integration, you can:

  • View linked Linear issues directly from customer records.

  • Track issue status in real time alongside deal and account progress.


How to connect Linear to Zero

1

In Linear, open your workspace Settings → Security & access.

Or use this link format (replace the placeholder with your workspace slug): https://linear.app/{your-workspace}/settings/account/security Example: https://linear.app/zero-crm/settings/account/security

2

Generate a new personal API key.

3

Grant at least Read access for the key. The key is copied to your clipboard and can’t be viewed again, so store it somewhere safe.

4

In Zero, go to Workspace Settings → Integrations. Scroll to Issue Tracker Integrations and create a new connection.

5

Select Linear, paste the API key you just created, and click Connect Integration.

6

After connecting, you’ll see this confirmation view.


How the integration works

  • Zero maps Linear issues to companies by linking them to associated customer requests.

  • To link an issue to a company in Zero, make sure the Linear issue is connected to a customer request.

  • Zero maps customer requests to company records by domain. Add the domain to your Customer objects in Linear (go to Customers, edit the customer, and add the domain). The domain must match the company’s domain in Zero.

  • By default, Zero pulls the last 30 days of data. You can trigger a full sync from the integration settings.


Where the data appears in Zero

  • In any list, add the properties related to Issues. These fields are shared with other issue trackers like Pylon and Plain.

  • Issues and Open issues give you a quick preview of total and open items, respectively.

  • Click an issue to see a quick preview and open it directly in Linear.

  • Issues by month shows how many issues a customer has raised over time. Hover over the bubbles to see a month-by-month breakdown.

  • You can also use Issues as an entity in Reports to chart the data and pin it to dashboards.

Last updated