Jira Cloud (OAuth 2.0)-

• Connect Jira Cloud to LinearB using OAuth 2.0.
• Authorize LinearB with a Jira user that has sufficient permissions.
• LinearB validates access and begins syncing Jira data automatically.
• Existing OAuth 1.0 connections can be upgraded without data loss.

Before connecting Jira Cloud, ensure the Jira user performing the authorization has:

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

If the user lacks sufficient permissions, the authorization may fail and require re-authorization with a different user.

1. Navigate to Settings > Project Management > Projects.
2. Select Jira as the project management tool and click Connect.
3. Under Connect Jira, choose Jira Cloud.
4. Click Connect to Jira to start the OAuth authorization flow. You will be redirected to Jira Cloud.
5. In Jira:
   1. Log in (if prompted).
   2. Review the permissions requested by LinearB.
6. Click Allow to grant access.
   The Jira user must have read and write permissions for all relevant projects. Insufficient permissions may cause the authorization to fail.
7. After approval, Jira redirects you back to LinearB automatically.
8. LinearB performs validation checks:
   1. Authorization code validation
   2. Token exchange
   3. Access verification
   4. Permissions validation
   This process may take a few minutes.
9. Once validation completes successfully, click Continue to activate the integration.

LinearB will begin syncing data from Jira Cloud, including projects, boards, issues, and incidents.

If your workspace is still using the legacy OAuth 1.0 Jira integration, you will see an upgrade banner in the Jira settings:

“We’ve upgraded our Jira integration — reconnect now using OAuth 2.0 for improved security.”

1. Go to Settings > Project Management > Projects.
2. Locate the Jira integration upgrade banner.
3. Click Authorize Jira.
4. Approve the new OAuth 2.0 authorization in Jira.
5. Return to LinearB and allow validation to complete.

The upgrade does not remove existing settings or historical data. Once completed, LinearB continues syncing Jira data using OAuth 2.0.

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

Common reasons for authorization failure:

• The Jira user lacks required permissions
• Multiple Jira sites are associated with the account
• Incorrect credentials were used
• The wrong Jira Cloud account was selected

Even after a successful connection, the Reauthorize option remains available so you can switch Jira users at any time.

If re-authorization fails, the integration remains in a failed state until corrected.