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

​
Sync interval configuration

Control how frequently Ravenna synchronizes data from your Linear workspace. By default, Ravenna syncs every 5 minutes, but you can adjust this based on your organization’s needs.
1

Navigate to integration settings

Go to Settings > Integrations and click on your connected Linear integration.
2

Configure sync interval

In the integration settings, locate the Sync Interval field and enter your desired interval in minutes.Recommended intervals:
  • 5 minutes (default): Best for active teams needing near-real-time sync
  • 15 minutes: Good balance for most teams
  • 30-60 minutes: Suitable for less active projects or to reduce API usage
3

Save changes

Click Save to apply the new sync interval.
The sync interval affects how quickly changes in Linear appear in Ravenna and vice versa. Lower intervals provide faster updates but increase API usage.