Integrate Aha! With Jira
Jira is the tracker for teams planning and building great products. Thousands of teams choose Jira to capture and organize issues, assign work, and follow team activity. At your desk or on the go with the new mobile interface, Jira helps your team get the job done.
Do your planning in Aha! and then move your initiatives, features, requirements, attachments, tags, and estimates into Jira with no hassle. As work gets done in Jira, updates flow back to Aha! to keep you in the know. You decide how you want to map initiatives, features, and requirements from Aha! to Jira. It's common to have them be epics, stories, and sub-tasks. But, it's totally up to you.
When a release is first sent from Aha! to Jira a corresponding version record will be created. This makes it easy to think about market-impacting releases in Aha! and do sprint planning and engineering management in Jira.
You need to be a product owner in Aha! and an administrator in Jira to set up this integration. Please carefully follow these instructions to ensure that the integration is properly configured. There are two steps to this integration and both must be completed. If you are using the on-premise version of Jira, you will need to create a firewall exception: see the IP Whitelist doc article for help.
Step 1: Add Jira account and mappings
- Configure the Server URL, Username, and Password. Click the Test connection button to pull all available projects into Aha!
- Choose the Project that the issues will be created in.
- Map how you want Features and Requirements in Aha! to show up in Jira.
- Map how Jira statuses will align with your statuses in Aha!
- Enable the integration.
- Test the integration by going to one of your features in Aha! and using the Send to Jira item in the Actions menu on the features page. You should then look at your project in Jira to make sure that the feature (and any requirements) were properly copied.
Note: You can add the integration multiple times if you want to integrate multiple Jira projects with a single Aha! product.
Step 2: Add the integration Webhook
This will enable changes in Jira to be reflected in Aha! and make the integration two-way.
- Copy the Webhook URL at the bottom of the configuration screen.
- In the Jira administration section on the System tab, choose Webhooks.
- Create a new Webhook in Jira and paste in the Webhook URL that you copied.
- Check the boxes for all Worklog and Issue events.
- Edit an Issue in Jira linked to an item in Aha! to verify that the two-way workflow is working.
Note: Only one webhook should be created per Aha! account. All subsequent integrations will be two-way automatically.
Once you have added the Jira integration, you can directly import your feature backlog with the import from Jira functionality.