How to use the Pivotal Target.

Before starting, make sure to have a API Token and the project ID from Pivotal. In the Pivotal account, go to My Profile and grab the API Token if one isn't there at the bottom of the page there is a Generate token link. The project ID is in the URL of the project  ( http://www.pivotaltracker.com/projects/ 123456).

After you have a token and the project ID go to Settings=>Extensions=> Targets and Add Target. Select the Pivotal Tracker.


Give your target a name and copy the Pivotal Tracker API token into the token field, copy the project ID into the Project ID field. Then pick one of the story types.

Types of Stories

There are four types of stories in Tracker: Features , Chores , Bugs , and Releases .

Feature Features are stories that provide verifiable business value to the team's customer. Examples of features include "add a 'special instructions' field to the checkout page", "purchase history should load in half a second", and "add a new method addToInventory to the public API". Features are worth points and therefore must be estimated.

Chore Chores are stories that are necessary, but provide no direct, obvious value to the customer. Examples include "sign up for access to geocoding service" and "Find out why the detailed test suite takes so long". Chores can represent "code debt", and/or points of dependency on other teams.

Bug Bugs represent unintended behavior that can be related to features, for example "login box is wrong color", and "price should be non-negative".

Release Releases are used to delimit a set of stories comprising a particular set of features. They can be thought of as a milestone, or a point in the backlog that is of some interest, such as when you will be prepared for a certain demonstration or to release updates to your live site.


Once the target has fired you will get a story placed in the Icebox with the subject of "From ticket#<ticket.id>". You can change this once you start tracking it within Pivotal.

Icebox - stories that have yet to be prioritized. Stories can stay in the icebox indefinitely, while they are 'on ice'. When ready, a story in the icebox can be prioritized by dragging it into the current panel or backlog panel.


In the description of the story will be what ever you have in the Message of the "Notify target' of the automation or trigger.



Please sign in to leave a comment.
Help them find what they're looking for
Create an online destination for 24/7 support with Zendesk