Integrate Aha! with Redmine

Coming soon: We are introducing a fresh new look for record drawer and details pages on September 30, 2020. This article describes the current experience. Preview the upcoming improvements in your account now so you can get familiar with the new way of working in Aha!

  • Switch to the new experience using a toggle in the More options button in the drawer of each record.
  • The toggle is unique to each user — so you can opt in and out as often as you like.
  • We also updated the application font in the new experience for improved text legibility.

This integration allows you to push your features, activities and requirements in Aha! into Redmine as issues. Redmine is a project management web application that is open source and released under the terms of the GNU General Public License v2 (GPL). 


Because this is a one-way integration, you can send your records with full strategic context from Aha! to your development team in Redmine, but they will not be able to send status updates back. You can also create multiple integrations per workspace to accommodate how the engineering team is split up. 

Note: Make sure you give each integration a unique name to keep the teams straight.

Click any of the following links to skip ahead:


Integration type
  • One-way (Aha! to Redmine)
Aha! level
  • Workspace level
Required user permissions: 
Required user permissions: 
Use integration
Associated records


  • Releases / Schedules
  • Features / Activities
  • Requirements


  • Versions
  • Issues


Features of the integration

  • One Aha! workspace is associated with one or more Redmine projects.
  • Individual features can be sent to Redmine using the Send dropdown on the features detail drawer and selecting Send to Redmine.
  • When a feature is copied to Redmine, one issue will be created for the feature. If the feature has requirements, then each requirement will also be sent as an issue.
  • Only the description of a feature or requirement is sent. No to-dos or comments are included.
  • Attachments of a feature or requirement are also sent.
  • Aha! releases will be created as versions in Redmine.
  • After a feature is first sent to Redmine, changes to the name, description, and requirements can also be sent to Redmine using the Update Redmine option from the More options dropdown. This option is located next to the link to the Redmine record within the Aha! feature. New requirements will also be created in Redmine. However, issues that were created for an existing requirement are not deleted from Redmine if the requirement is deleted from Aha! If an attachment is deleted on the Aha! side, the corresponding attachment in Redmine is not deleted.


Create the integration

  1. Navigate to Settings ⚙️ > Workspace and then click on the + icon next to integrations in the left rail.
  2. Select Redmine.
  3. Click on the Create Integration button below the instructions.
  4. Enter your Redmine url and the API access key. You can find the API access key for a specific Redmine user by going to user's My account page. The API access key can be revealed on the right-side menu. Click the Test connection button.
  5. After a short delay, you will be able to choose the project the issues will be created for.
  6. Enable the integration.
  7. Test the integration by going to one of your features in Aha! and clicking on the 
    Send to Redmine option under the Send menu on the features detail drawer. You should then look at your Redmine project and see that the feature and any requirements were properly copied to issues.



Test the integration

Test the integration by going to one of your features in Aha! and using the Send dropdown on the features detail drawer. You should then look at your project in Redmine and see that the feature (and any requirements) were properly copied.

Note: You can add the integration multiple times if you want to integrate multiple projects with a single Aha! workspace. Once you have added an integration, you may change the title to specify the project this integration belongs to by clicking on the title at the top of the integration setup page.


Manage your integration

If you have multiple Redmine integrations that you need to manage, use the Manage integrations report, located in Settings ⚙️ > Workspace > Integrations



To help you troubleshoot an error, we provide detailed integration logs below the integration's configuration page.

Still stuck? Contact our Customer Success team at, and we would be happy to help.


Was this article helpful?
0 out of 0 found this helpful