Integrate Aha! with Pivotal Tracker

This integration allows you to push your features, activities and requirements in Aha! into Pivotal Tracker and get status changes back. Because this is a two-way integration, your strategy can flow from Aha! to your development team in Pivotal Tracker, and receive status updates back as they complete the work. 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.

Support - Integrate Aha! with Pivotal Tracker - inline image

Click any of the following links to skip ahead:


Integration type

  • Two-way

Aha! level

  • Workspace level

Required user permissions:

Required user permissions:
Use integration

Associated record types


  • Features / Activities

  • Requirements

Pivotal Tracker

  • Epics

  • Stories

  • Tasks


Features of the integration

When Aha! sends a feature or activity to Pivotal Tracker, it sends the following fields: name, description, requirements, attachments, and story point estimates.

From Aha! to Pivotal Tracker

  • One Aha! workspace is associated with one or more Pivotal Tracker projects.

  • Individual features can be sent to Pivotal Tracker using the Integrations dropdown on the features details or drawer view.

  • All features in a release (that have not already been implemented or sent to Pivotal Tracker previously) can be sent to Pivotal Tracker using the Integrations dropdown on the release page.

  • Features can be mapped to epics or stories in Pivotal Tracker.

  • Requirements, which live in features, can be mapped to stories or tasks in Pivotal Tracker.

  • Only the description and attachments of a feature or requirement are sent. No Aha! to-dos or comments are included.

  • When a feature is sent to Pivotal Tracker, its status in Aha! is automatically changed to Ready to develop.

  • After a feature is first sent to Pivotal Tracker, changes to the name, description, and requirements can also be sent to Pivotal Tracker using the Update pivotal tracker option within the Integrations dropdown on the features page or by sending all features in a release to Pivotal Tracker again.

  • New requirements will also be created in Pivotal Tracker, however, stories that were created for an existing requirement are not deleted from Pivotal Tracker if the requirement is deleted from Aha! If an attachment is deleted in Aha!, the corresponding attachment in Pivotal Tracker is not deleted.

From Pivotal Tracker to Aha!

Changes in Pivotal Tracker will be reflected in Aha! in real time. This enables you to track what stories have been completed automatically. The following fields will flow into Aha! from Pivotal Tracker:

  • Story name

  • Story description

  • Story or task status

  • Story point estimates



In Pivotal Tracker

  1. Go to the Settings page for the project, and then choose the Integrations tab or choose Configure Integrations.

  2. Under External Tool Integrations at the bottom of the page, create a new Other integration.

  3. Name the integration "Aha!" and set the Base URL to "https://<yourdomain→" (where <yourdomain→ is the sub-domain for your account).

  4. Mark the integration as Active, leave the other fields blank, and save the integration.

  5. On the Profile page, copy the API token.

In Aha!

  1. Under Settings ⚙️ → Workspace, click on the + icon next to Integrations.

  2. Select Pivotal Tracker.

  3. Enter your API host for your private cloud, on-premise Pivotal Tracker. If you are using on-demand Pivotal Tracker, leave this field blank.

  4. Enter the API token you copied from Pivotal Tracker. Click the Test connection button. After a short delay, you will be able to choose the project the stories will be created in.

  5. Choose the integration in Pivotal Tracker that you created previously.

Back in Pivotal Tracker

  1. Create a new Activity Webhook for v5 in Pivotal Tracker and paste in the Hook URL.

  2. Enable the integration.

Configure field mappings

You can choose to send initiatives, features, and requirements over as follows:

  • Feature → Story, Requirement → Story

  • Feature → Epic, Requirement → Story

  • Feature → Story, Requirement → Task

  • Initiative → Epic, Feature → Story, Requirement → Task

You may also map feature statuses and feature types between Aha! and Pivotal Tracker.

Test the integration

Test the integration by opening one of your features in Aha!, then using the Integrations dropdown and selecting Send to Pivotal Tracker. You should then look at your project in Pivotal Tracker 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 Pivotal Tracker 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.


Aha! Roadmaps
Strategic roadmaps
Jira integration troubleshooting
      Aha! Ideas
      © 2020 Aha! Labs Inc.All rights reserved