Skip to main content
Connect to Linear using OAuth authentication
This guide walks you through connecting to your Linear workspace to enable bidirectional issue synchronization.

​
Prerequisites

Before you begin, ensure you have:
  • Admin access to your Linear workspace
  • Linear workspace with active projects and teams

​
Setup guide

1

Navigate to integrations

  1. Go to Settings > Integrations
  2. Find Linear in the Ticketing section
2

Select Linear integration

Click Connect on the Linear integration card
3

Authorize with Linear

  1. You’ll be redirected to Linear’s authorization page
  2. Review the requested permissions:
    • Read and write issues
    • Read projects and teams
    • Read and write comments
  3. Click Authorize to grant access
4

Complete setup

After authorization, you’ll be redirected back with the integration connected
5

Link tickets to issues

  1. Go to a ticket you want to sync
  2. Click the Link button or integration menu
  3. Connect it to an existing Linear issue
  4. Updates will now sync bidirectionally

​
Troubleshooting

Cause: Insufficient permissions or expired sessionSolution:
  • Ensure you have admin permissions in Linear
  • Try disconnecting and reconnecting the integration
  • Clear browser cache and retry authorization
  • Verify your Linear workspace is accessible
Cause: Ticket not properly linked or permission issuesSolution:
  • Verify the ticket is linked to a Linear issue
  • Check that team and project IDs are valid
  • Ensure the authorized user has permission to edit issues
  • Try unlinking and relinking the ticket
Cause: Projects not accessible or integration needs refreshSolution:
  • Refresh the integration by disconnecting and reconnecting
  • Ensure the Linear workspace has active projects
  • Verify the authorized user has access to the teams
  • Check team permissions in Linear
Cause: OAuth authorization missing required permissionsSolution:
  • Verify the OAuth authorization granted all required permissions
  • Re-authorize the integration with full permissions
  • Check Linear workspace settings for app restrictions
  • Ensure the user has team admin access

​
Features

Once connected, Linear provides real-time bidirectional synchronization:
https://mintcdn.com/ravenna/sHkIxR1kZRcsw3Gd/icons/linear.svg?fit=max&auto=format&n=sHkIxR1kZRcsw3Gd&q=85&s=050100e23ca2c22c12d3a01ea83845c4

Linear Integration Features

Bidirectional sync of tickets and issues, including comments, status changes, and assignee updates