If you are using correct credentials to enable your Jira Cloud integration, but still seeing a 401 authentication error, you may need to adjust your integration credentials.
Use an API key
In April 2019, Jira began to move away from password authentication for accessing the Jira Cloud API. You must now authenticate with Jira using an API token.
If you are using a Jira 2.0 integration, follow these instructions to update your authentication method from user/password to API token for each one of your Jira integrations.
- The first step is to create an API token in Jira. Follow these instructions from Jira on how to create an API token for your user account.
- Navigate to Settings ⚙️> Workspace and select your Jira integration. Note: If your integration setup uses an integration template, you only need to update the template.
- Navigate to the Configure Account integration step.
- Paste the Jira API token from step 1 into the Password field and save. Important note: For Jira Cloud customers, the Jira user's email address must be used in the Username field.
If you are using a Jira 1.0 integration, you can update the password in the integration settings.
Use your Jira email address in the Aha! username field
The Username field requires the email address you use to log in to your Jira account, not a username. Confirm that you have used an email address here, then click Test connection to see if you have resolved the issue.
If you are still receiving a 401 authentication error even with correct credentials, please reach out to our Customer Success team at firstname.lastname@example.org.