Link records in Aha! with existing records in another system

Once you have set up your development tool integration, you may find that you have records that already exist in both Aha! and your development system. It’s important to keep everything in sync without creating duplicates, so Aha! allows you to link Aha! records with existing records in your development tool.

How it works

In the Integrations section for a mapped record type, you will see a Send dropdown. When you open this dropdown, choose Link with an existing record.


You will be asked to identify the record that you would like to link. The unique identifier will be different for each development tool, so make sure to follow the instructions presented on the screen.


When the record has been found in your development tool, you will need to determine which system contains the data that you would like to use. You have two options:

  • Use Aha! and overwrite Jira: This option creates a link between the two records and updates Jira with the data found in Aha! for your mapped fields.
  • Use Jira and overwrite Aha!: This option creates a link between the two records and updates Aha! with the data found in Jira for your mapped fields.

If a field contains no data, it will remove data from the mapped field in the tool you choose to overwrite. Aha! will display the fields that are mapped along with the data they contain to help you make the best choice.


Once your records are linked, the link will appear in the Integrations section of your record.

Relationship links

If you are using relationship links in your integration, you’ll want to follow a simple rule. Always start at the top by linking the parent record first. This ensures that the child records will retain the proper parent relationship when they are linked. Here is a basic order for how you would link the records.

  1. Release
  2. Initiative
  3. Master feature
  4. Feature
  5. Requirement

Keep in mind that your integration may not contain relationship links for all of these record types. You can always skip linking those records that aren’t applicable to your integration.

When linking any record, Aha! does not attempt to link any of the child records. These must be linked individually.

When you link a child record without first linking the parent records, you will encounter some unexpected behavior.

Using Aha! and overwriting Jira:

  • The parent links will be lost in both Aha! and Jira.
  • If you attempt to link a requirement that doesn’t have a linked parent feature, you will receive an error because the parent record in the development system is unknown.

Using Jira and overwriting Aha!:

  • New parent records will be created (duplicated) in Aha! and your record will be linked to the new parent records.

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