Integrations overview

Tracker has integrations with several popular tools, including defect-tracking systems and customer support apps like Bugzilla, JIRA, and Zendesk.

Tools such as Slack and GitHub also have integrations with us—see the Tracker Integrations page for more.

Tracker can also publish activity in your project to a Campfire chatroom or a custom application that listens to HTTP requests. You can create other integrations in any project you own that allow you to import from and link to Tracker stories, to tickets or issues in external bug tracking, or to customer support applications. You can also associate your source code commits with stories and update story state automatically via special commit message syntax.

You may need to open up your firewall to allow incoming requests from Tracker integrations (e.g., if you have an internal JIRA instance). If you need this, ask your network administrator to allow the IP addresses for the following:

  • app01.pivotaltracker.com

  • app02.pivotaltracker.com

However, please note that the IPs assigned to these addresses may change without notice.

Setting up an external tool integration

Your team can use Tracker to prioritize and collaborate around stories that are linked to issues/tickets in other systems (e.g., bug-tracking applications, customer support ticket systems, etc.). You can find more detailed setup information for each external tool integration in that specific tool’s Help Center article. However, in general, creating an integration will require the following steps:

  1. Click the MORE tab in your project view, then choose Integrations from the sidebar.

  2. Click the Add an integration button and select the type of integration you’d like to add.

  3. Configure the integration. Most will require some form of user credentials, location/URL information, and possibly the ID of a saved search or a filter.

  4. After you create an integration, you should see a new option in your project’s sidebar with the name you gave your integration.

  5. Click on the integration name from the sidebar. If you’ve configured the integration properly, when you open the Integrations panel, you should see a list of tickets or issues from the external tool:
    A list of tickets or issues displayed in Tracker from the external tool for JIRA.

  6. Drag an issue or ticket into the Icebox or Backlog. This will create a new story, linked to the external issue/ticket. Stories that have external links display an “E” in the story icon, as shown here:
    A story in Tracker with an 'E' displayed in the story's bug icon.

  7. Work on linked stories in Tracker. Depending on the integration type, state changes and comments to linked stories will be reflected in the integrated external tool/application. For example, starting a linked story will mark the corresponding JIRA issue as In Progress, and when the story gets accepted, the ticket will be marked as Resolved.
    Comment activity shown in JIRA, generated from the Tracker integration.

Integrations permissions

This table describes the actions users can take with integrations if they are part of an account with an enterprise plan—whether or not they are a member of an account—as well as the project to which they would like to add an integration, and their role on that project.

Is Enterprise User Is Account Member Project Role Can View Integration Can Edit Integration Can Delete Integration
True True Owner Yes Yes Yes
True True Member Yes No No
True True Viewer Yes No No
True False Owner Yes No No
True False Member Yes No No
True False Viewer Yes No No
False True or False Owner Yes Yes Yes
False True or False Member Yes No No
False True or False Viewer Yes No No
Next
JIRA