Linear Integration

📘

The Linear integration is currently in Beta and is available on Business and Enterprise plans.

Connect your Linear workspace to Socket to create and manage Linear issues directly from Socket alerts. Create issues manually from individual alerts, or set up automated ticketing rules that create and update Linear issues based on alert events in your organization.

The integration connects to Linear using OAuth. Authorization happens entirely from the Socket dashboard — there is no separate app to install in a third-party admin console.

Key capabilities

• Manual issue creation — Create a Linear issue from alerts in the Socket dashboard.
• Automated ticketing rules — Define rules that automatically create Linear issues when specific alert events occur, with configurable conditions, team, project, priority, and labels.
• Multi-workspace support — Connect more than one Linear workspace to a single Socket organization.
• Multi-organization support — A single Linear connection can optionally be shared across multiple Socket organizations.

Prerequisites

• Confirm your Socket account is on a Business or Enterprise plan.
• Have a Linear workspace ready, with permission to authorize apps for the workspace and teams you want to connect.
• Hold an Owner or Admin role in your Socket organization (required to connect and disconnect the integration).

Connect Linear to Socket

Step 1: Open the Linear integration page

In the Socket dashboard, go to Settings → Integrations → Linear for your organization, then click Connect.

A dialog opens with step-by-step instructions and an installation link.

Step 2: Start the authorization

1. Click Install to open the Linear authorization window.
2. If the authorization window does not open, your browser may be blocking popups. Allow popups for this site, or copy the installation link shown in the dialog and open it in a new browser tab.

Step 3: Approve the requested permissions in Linear

In the Linear authorization window:

1. Select the correct workspace in the top-left corner.
2. Select the teams you want Socket to be able to create issues for.
3. Review the requested permissions and click Authorize.

Socket requests the following Linear OAuth scopes:

• Read — Read workspace data such as teams, projects, labels, and priorities.
• Write — Create and update issues on your behalf.
• Create issues — Create new issues from alerts and ticketing rules.
• Create comments — Add comments to issues to keep them in sync with alert activity.
• Subscribe to issue updates — Receive notifications when issues are updated.

Step 4: Verify the connection

After you authorize, the Socket dashboard reloads automatically and the connection appears under Settings → Integrations → Linear with a Connected status badge, including who connected it and when.

Tip: To connect additional Linear workspaces, repeat the steps above.

Disconnect Linear

To disconnect a Linear workspace from your Socket organization:

1. Go to Settings → Integrations → Linear in the Socket dashboard.
2. Find the Linear connection you want to remove.
3. Click the button with the 3 dots, and select Disconnect..., then confirm.

This removes the link between the Linear workspace and your Socket organization. If the same connection is shared with another Socket organization, it remains connected to that organization.

Alternatively, a Linear admin can revoke the connection in the Linear workspace settings.

📘

If a connection shows an Error or revoked status, remove the connection and create a new one to restore access.

Multi-organization support

By default, a Linear connection is tied to the Socket organization that authorized it. A single Linear connection can also be shared across multiple Socket organizations. When you authorize a connection that is eligible to be shared, Socket prompts you to select which organization to connect it to.

1. Go to Settings → Integrations → Linear in the Socket dashboard.
2. Find the Linear connection you want to remove.
3. Click the button with the 3 dots, and select Options...
4. Toggle the switch to allow shared connection, and click the Connect... button.

5. Select the organization you want to connect, and confirm the connection.

Create Linear issues from alerts

Once the integration is connected, you can create Linear issues directly from alerts in the Socket dashboard.

1. Open an alert in the Socket dashboard.
2. Click the Create Ticket button.
3. Select the Linear workspace, team, project, and fill in any additional fields.
4. Submit to create the issue.

The created issue is linked to the alert, and a link to the Linear issue appears on the alert so you can navigate directly to it.

Automated ticketing rules

Automated ticketing rules let you define conditions under which Linear issues are automatically created and updated. Configure these rules from Settings → Integrations → Ticketing in the Socket dashboard.

📘

Ticketing is available on Business and Enterprise plans.

Create a ticketing rule

Click Create Configuration to start the wizard:

1. Select events

Choose which events should trigger the rule.

2. Select conditions

Optionally define conditions to filter which alerts match this rule, targeting specific alert types, priority levels, repositories, or other attributes.

3. Select project

Choose the Linear connection and where issues should be created:

• Integration — Select which connected Linear workspace to use.
• Team — Select the Linear team that issues will be created in.

4. Configure issue

Define how the Linear issue should be created:

• Priority — Set a specific priority, or use Auto to map the alert priority to a Linear priority automatically.
• Labels — Optionally add labels to created issues.
• Assignee – Optionally add an assignee using email or display name.

Note: additional settings are not supported for Linear.

5. Configure actions

Define what happens when alert state changes, such as creating a new issue when conditions are met and updating the linked issue when the alert changes.

After reviewing the summary, click Create to activate the rule.

Permissions

Socket roles

Linear app permissions

When you authorize the integration, Socket requests permission to read workspace data and to create and update issues and comments for the teams you select. Socket does not access data outside the workspace and teams you authorize.

Troubleshooting

Known issues and limitations

Next steps

• Webhooks — Set up webhooks to receive real-time notifications for alert events.
• Customizable Security Policies — Configure which alert types trigger warnings and blocks across your organization.
• Organization Alerts — Review and manage alerts across all repositories in your organization.