2021-09-30 23:02:18 +05:30
---
2022-11-25 23:54:43 +05:30
stage: Manage
2021-10-27 15:23:28 +05:30
group: Integrations
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2021-09-30 23:02:18 +05:30
---
# Pivotal Tracker service **(FREE)**
This service adds commit messages as comments to Pivotal Tracker stories.
Once enabled, commit messages are checked for square brackets containing a hash mark followed by
the story ID (for example, `[#555]` ). Every story ID found gets the commit comment added to it.
You can also close a story with a message containing: `fix [#555]` .
You can use any of these words:
- `fix`
- `fixed`
- `fixes`
- `complete`
- `completes`
- `completed`
- `finish`
- `finished`
- `finishes`
- `delivers`
Read more about the
[Source Commits endpoint ](https://www.pivotaltracker.com/help/api/rest/v5#Source_Commits ) in
the Pivotal Tracker API documentation.
2021-11-18 22:05:49 +05:30
See also the [Pivotal Tracker integration API documentation ](../../../api/integrations.md#pivotal-tracker ).
2021-09-30 23:02:18 +05:30
## Set up Pivotal Tracker
In Pivotal Tracker, [create an API token ](https://www.pivotaltracker.com/help/articles/api_token/ ).
Complete these steps in GitLab:
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Projects** and find your project.
2022-06-21 17:19:12 +05:30
1. On the left sidebar, select **Settings > Integrations** .
2021-09-30 23:02:18 +05:30
1. Select **Pivotal Tracker** .
1. Ensure that the **Active** toggle is enabled.
1. Paste the token you generated in Pivotal Tracker.
2022-01-26 12:08:38 +05:30
1. Optional. To restrict this setting to specific branches, list them in the **Restrict to branch**
2021-09-30 23:02:18 +05:30
field, separated with commas.
1. Select **Save changes** or optionally select **Test settings** .
