The Linear integration lets you turn Intruder issues and advisories into Linear tickets, so your engineers can triage and fix them in the tool they already use. You connect Linear once with a Personal API Token, choose a team and project, then push issues to Linear from their detail view. The integration is one-way: pushing an issue creates a Linear ticket, but changes in Linear don't flow back to Intruder.
🎫 Plan availability: The Linear integration is available on our Cloud, Pro, and Enterprise plans.
What is the Linear integration?
The Linear integration is a one-way connection that creates Linear tickets from Intruder issues and advisories. Once you've connected it, you push an issue or advisory to Linear from its detail view, and Intruder creates a ticket in the Linear team and project you chose.
Once an issue has been pushed, a Linear icon appears next to it in the issue list, and the ticket shows in the Tickets section of that issue's detail panel.
How to connect Linear to Intruder
📌 Prerequisites
You need:
To be an Intruder admin to set up the integration.
A Linear account with access to the team and project you want to push issues into
A Linear Personal API Token (created in the first step below)
Connect Linear in two parts:
Step 1 - Create a Personal API Token in Linear
Step 2 - Add and configure the integration in Intruder.
ℹ️ Note:
We only recommend connecting using a specific "integration user" on Linear. This is a user who has the minimum permissions, only to be used for the `Linear → Intruder` integration.
Linear shows the Personal API Token only once when you create it, so copy it before you close the dialog.
Create a Linear Personal API Token. In Linear, go to Settings → Personal → Security & Access, find Personal API keys, and click New API key. Give it a clear name (for example, "Intruder"), apply any desired project-specific permissions, create it, then copy the key.
Open the Integrations page in Intruder and select the Linear card. Note that you will need to be an Intruder admin to set up the integration.
Paste your Personal API Token and save. Intruder checks the connection with Linear before continuing.
Choose a Linear team. Intruder lists the teams your token can access.
Choose a project within that team.
Set the auto-create issues severity level for the integration. This controls which issues are automatically exported to Linear based on the selected severity level.
(Optional) Send a test issue. Intruder pushes a sample ticket to your Linear project so you can confirm the team and project are set up correctly before you push real issues.
Creating Issues in Linear
Manually export issues to Linear
To manually export an Intruder issue to Linear, go to the Issues page, select the issue, and select Actions, then Send to Linear
Select the Linear team and issue type you want to export the issue to, then select Submit. The issue will be exported to your Linear project.
Automatically create Linear issues for new security weaknesses
To automatically create Linear issues, go to Integrations > Linear Settings. In the Vulnerability Issues section, select the team, issue type, and severity of the issues you want to export.
After you push an issue, a Linear icon appears next to it in the issue list, so you can see at a glance which issues are already tracked. The new ticket also appears in the Tickets section of the issue's detail panel, with a link to open it in Linear.
How the issue is displayed
…within Intruder
Once an issue has been sent to Linear, you'll see Linear ticket references in two places:
By hovering over the Linear logo next to the issue title
Under the Tickets section within the issue details panel
Selecting these links takes you directly to the corresponding ticket in your Linear workspace.
…within Linear
After export, the issue is added to your Linear backlog. The ticket includes:
A clear description of the issue
Remediation guidance
A list of affected occurrences with links to view them in the Intruder portal
This helps your team locate, assess, and address the vulnerability efficiently.
FAQ
Does the Linear integration use OAuth?
No. The integration authenticates with a Linear Personal API Token only. You create the token in Linear and paste it into Intruder.
Can I push more than one issue to Linear at once?
No. Bulk push isn't supported. Push issues to Linear individually from each issue's detail view.
If I resolve an issue in Linear, does the issue get automatically rescanned in Intruder?
No. The integration is one-way, so resolving an issue in Linear does not affect the Intruder issue. You manage scans within Intruder as usual.
Where do I see the issues I've already pushed?
A Linear icon appears next to pushed issues in the issue list, and each pushed ticket shows in the Tickets section of the issue's detail panel.
Can I connect more than one Linear team or project?
The integration connects to one Linear team and project at a time. To change where issues go, update the team and project in the integration settings.
Troubleshooting
Intruder says my Personal API Token is invalid when I try to connect.
Cause: The token has a typo, has been revoked, or doesn't have permission to create issues.
→ Fix: Create a fresh token in Linear (Settings → Personal → Security & Access), make sure it has write/create-issue access, and paste it again.
I can't create a Personal API Token in Linear.
Cause: Your Linear admin has restricted who can create personal API keys.
→ Fix: Ask a Linear admin to allow member API keys (Settings → Administration → API → Member API keys) or to provide a token for you.
No teams or projects appear when I configure the integration.
Cause: The user who created the token has no access to any teams or projects, or the token's access is scoped too narrowly.
→ Fix: Check the token's team access and permissions in Linear, or use a token from a user with access to the team and project you want.
Pushing an issue to Linear fails with an error.
Cause: The token has lost write access, the connected project has been removed, or Linear's API returned an error.
→ Fix: Re-check the connection in the integration settings and send a test issue. If the test fails, reconnect with a new token and reselect the team and project.
I get a permission error when I try to configure the integration.
Cause: Your Intruder role doesn't allow managing integrations.
→ Fix: Ask an Intruder admin to set up the integration or to grant you the required role of Admin.