Skip to main content
Connect to Jira using OAuth authentication
This guide walks you through connecting to your Jira workspace to enable configuration management and status mapping.

​
Prerequisites

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

​
Setup guide

1

Navigate to integrations

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

Select Jira integration

Click Connect on the Jira integration card
3

Authorize with Jira

  1. You’ll be redirected to Jira’s authorization page
  2. Select your Jira workspace from the dropdown
  3. Review the requested permissions:
    • Read and write issues
    • Read projects
    • Read and write comments
  4. Click Authorize to grant access
4

Complete setup

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

​
Troubleshooting

Cause: Insufficient permissions or expired sessionSolution:
  • Ensure you have admin permissions in Jira
  • Try disconnecting and reconnecting the integration
  • Clear browser cache and retry authorization
  • Verify your Jira workspace is accessible
Cause: Projects not accessible or integration needs refreshSolution:
  • Refresh the integration by disconnecting and reconnecting
  • Ensure the Jira workspace has active projects
  • Verify the authorized user has access to the projects
  • Check project permissions in Jira
Cause: OAuth authorization missing required permissionsSolution:
  • Verify the OAuth authorization granted all required permissions
  • Re-authorize the integration with full permissions
  • Check Jira workspace settings for app restrictions
  • Ensure the user has project admin access

​
Features

Once connected, you can configure Jira settings:
https://mintcdn.com/ravenna/sHkIxR1kZRcsw3Gd/icons/jira.svg?fit=max&auto=format&n=sHkIxR1kZRcsw3Gd&q=85&s=01fea6b649834bc1b3d27ec06578b733

Jira Configuration

Configure status mapping between ticket statuses and Jira workflow states for consistent terminology