Skip to main content
With the Linear integration, you can send alerts from Plerion directly into your chosen Linear project, allowing your team to prioritize and resolve issues within your existing workflow.
Note: This is a one-way outbound integration. Alerts created or updated in Plerion will appear in Linear, but changes made directly in Linear will not sync back to Plerion.

​
Steps to integrate Linear with Plerion

1

On the Plerion dashboard, go to Settings > Integrations

Sidebar navigation showing Settings expanded with Integrations selected
2

Find Linear and click the + button

Integrations page with Linear option and plus button to add integration
3

On the Linear integration page, enter a name for your integration and select Connect

Connect Linear page showing fields for integration name and Connect button
4

A Linear OAuth pop-up will appear

Review the requested permissions and click Authorize to authorize the connection.
5

Test your Linear integration

After connecting Linear, click Create test issue to confirm that the integration works.
Select the Linear team and, optionally, the project where the test issue should be created.
Test issue configuration screen for Linear integration in Plerion
6

Review your test issue in Linear

If the test is successful, Plerion will display a link to the issue created in Linear.
Plerion confirmation showing link to created Linear issue

​
Create a workflow on Plerion

After adding the Linear integration, you must create a workflow for any alerts to be sent to Linear.
1

Go to Settings > Workflows and click Add a new workflow

2

Enter workflow details

Enter a workflow name and ensure the Enabled toggle is turned on.
3

Add workflow conditions

  • Under Conditions, you can build the workflow using any of the three available condition categories:
    • Asset
    • Findings
    • Vulnerabilities
Linear supports all three categories, allowing you to send alerts of any type to Linear based on the conditions you define.
4

Add workflow actions

Under Actions, click Add action and select your Linear integration.
Select the team, project, and preferred completed issue status for this workflow.
Plerion workflow setup for Linear integration
5

Save the workflow

Click Save to finish setting up your workflow.