Connecting Jira Cloud to LinearB (OAuth 2.0)

• Connect Jira Cloud to LinearB using OAuth 2.0 (required for Jira Cloud).
• Authorize LinearB in Jira and return to LinearB to complete validation.
• Upgrade from the legacy OAuth 1.0 integration to OAuth 2.0 without losing data.
• Use Reauthorize if the connection fails or if you need to switch the Jira user.

Before connecting, confirm the Jira user who performs the authorization has:

• Read and write permissions for all relevant Jira projects.
• Permission to authorize third-party applications in Jira Cloud.

If the user does not have adequate permissions, the connection may fail and require re-authorization using a different Jira user.

1. In LinearB, go to Settings → Project Management → Projects.
2. Choose Jira as the management tool and click Connect.
3. Under Connect Jira, select Jira Cloud.
4. Click Connect to Jira to begin the OAuth 2.0 authorization flow.

If your Jira deployment is hosted on-premises, see the Jira Server (On-Prem) Connection Guide .

1. You’ll be redirected to Jira Cloud (log in if prompted).
2. Review the permissions LinearB is requesting.
3. Click Allow to grant access.

After you approve access, Jira redirects you back to LinearB automatically.

After Jira redirects you back to LinearB, LinearB runs validation checks. This may take a few minutes.

• Authorization Code
• Token Exchange
• Access Check
• Permissions

1. Wait until all validations pass.
2. Click Continue to activate the integration.

Once activated, LinearB begins syncing Jira Cloud data (projects, boards, issues, and incidents) and correlating it with Git activity.

If your LinearB workspace is still using the legacy OAuth 1.0 Jira integration, you’ll see an upgrade banner on the Jira settings page. Upgrading does not remove your existing settings. After authorization succeeds, LinearB continues syncing Jira data under OAuth 2.0.

1. Go to Settings → Project Management → Projects.
2. Under Jira, find the upgrade banner.
3. Click Authorize Jira.
4. You’ll be redirected to Jira to approve the new OAuth 2.0 authorization.
5. After allowing access, you’ll return to LinearB where the integration completes validation.

Result: Your existing Jira settings remain in place, and LinearB continues syncing your Jira projects, boards, and issues under OAuth 2.0.

If the initial authorization fails, or if you need to connect using a different Jira user, click Reauthorize from the Jira connection panel.

Common reasons the connection fails:

• The Jira user does not have the required permissions.
• Multiple Jira sites are detected and the wrong site was selected.
• Incorrect credentials or the wrong Jira Cloud account was used.

Even after a successful connection, the Reauthorize option remains available so you can switch Jira users at any time. If re-authorization fails, the Jira integration remains in a failed state until corrected.

If issues persist, contact support@linearb.io or visit the LinearB Help Center.

• Sync Jira data (projects, boards, issues, and incidents) and correlate it with Git activity.
• Improve visibility into project progress and task execution.
• Reduce setup issues with built-in validation checks.
• Maintain continuity when upgrading from OAuth 1.0 to OAuth 2.0 without losing existing data.