Skip to main content

Linking Jira Tickets

Connect your Jira instance to Unwrap's Linked Actions to seamlessly bridge customer feedback with development work.

Required Permissions​

To connect Jira with Unwrap, the account used for authentication must have the "Administer Jira" global permission. This permission allows Unwrap to use Jira's features to keep tickets synced, ensuring a seamless experience across both platforms.

Setting Up Your Jira Connection​

Step 1: Generate an API Token​

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
  2. Click "Create API token"
  3. Give your token a descriptive name (e.g., "Unwrap Integration")
  4. Copy the generated token - you'll need this for authentication

Step 2: Connect in Unwrap​

  1. Navigate to your Organizations page
  2. Find the Jira integration and click "Connect"
  3. Enter your Jira domain, email, and the API token from Step 1

Troubleshooting Authentication Issues​

Re-authenticating Your Connection​

If you need to update your Jira connection (for example, if the original account holder has left your company):

  1. Go to your Organizations page
  2. Click the "Connected" button next to your Jira integration
  3. Update your credentials with a new account that has the "Administer Jira" permission
  4. Use the "Validate" button to test the new connection

Common Issues​

  • 403 Forbidden Error: This typically means the connected account doesn't have the "Administer Jira" permission
  • Authentication Failed: The account may no longer exist or the API token may have expired

Need Help?​

If you're experiencing issues with your Jira integration, please reach out to us at contact@unwrap.ai or any support channel with:

  • Your Jira domain
  • The email address you're trying to connect with
  • Any error messages you're seeing