Linear Integration
Corridor integrates with Linear to sync security findings. When you discover a vulnerability in Corridor, create a Linear issue with one click.
Features
- Two-way sync: Changes in Linear reflect in Corridor and vice versa
- Issue creation: Create Linear issues from Corridor findings
- Status sync: Issue status updates automatically
Connecting Linear
Authorize the integration
- Go to Team Settings → Integrations
- Click Connect Linear
- Sign in to your Linear workspace
- Authorize Corridor to access your workspace
- Select which teams to sync
After connecting, configure how data syncs:
| Setting | Description |
|---|
| Default team | Which Linear team receives new issues |
| Default project | Linear project for new issues |
| Label mapping | Map Corridor labels to Linear labels |
| Status mapping | Map Corridor states to Linear statuses |
Creating issues from findings
When you discover a security issue in Corridor:
- Open the finding
- Click Create Linear Issue
- Review the pre-filled issue details
- Select the team and project
- Click Create
The finding now links to the Linear issue.
Pre-filled fields
Corridor automatically populates:
- Title: Finding title
- Description: Finding details with context
- Labels: Mapped from finding severity
- Priority: Based on finding severity
Two-way status sync
When you update a Linear issue:
| Linear Status | Corridor State |
|---|
| Todo, Backlog | Open |
| In Progress | Open |
| Done, Completed | Closed |
| Canceled | Won’t Fix |
| Corridor State | Linear Status |
|---|
| Open | (no change) |
| Closed | Done |
| Won’t Fix | Canceled |
Viewing linked issues
In Corridor
Linked Linear issues appear on:
- Finding detail pages
- PR review findings
Click the Linear issue link to open it in Linear.
In Linear
Corridor adds metadata to linked issues:
- Link back to the Corridor finding
- Corridor project and severity labels
Webhooks
Corridor listens for Linear webhook events:
| Event | Action |
|---|
| Issue updated | Sync status to Corridor |
| Issue deleted | Update Corridor link |
| Comment added | Sync to Corridor (optional) |
- Go to Team Settings → Integrations → Linear
- Click Webhook Status
- Check for delivery errors
Bulk operations
Sync multiple findings to Linear at once:
- Go to Findings in your project
- Select findings using checkboxes
- Click Bulk Actions → Create Linear Issues
- Configure settings for all selected findings
- Click Create All
Label mapping
Map Corridor severity levels to Linear labels:
- Go to Team Settings → Integrations → Linear
- Click Label Mapping
- For each severity level, select a Linear label
- Click Save
Example mapping:
| Corridor Severity | Linear Label |
|---|
| Critical | P0 |
| High | P1 |
| Medium | P2 |
| Low | P3 |
Disconnecting Linear
To remove the integration:
- Go to Team Settings → Integrations
- Find Linear and click Disconnect
- Confirm the action
Disconnecting doesn’t delete existing links. Issues remain linked but won’t sync.
Troubleshooting
Sync not working
- Verify the integration is connected in Team Settings
- Check webhook delivery status
- Ensure you have write access to the Linear team
- Try disconnecting and reconnecting
Status not updating
- Check the status mapping configuration
- Verify the Linear issue is in a synced team
- Look for webhook errors in integration settings
Issue creation fails
- Ensure you have permission to create issues in the target team
- Check that required fields are populated
- Verify the Linear workspace is still connected
Next steps
