2021-04-29 21:17:54 +05:30
---
2021-10-27 15:23:28 +05:30
stage: Ecosystem
group: Integrations
2021-04-29 21:17:54 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---
2021-11-18 22:05:49 +05:30
# Asana integration **(FREE)**
2021-04-29 21:17:54 +05:30
2021-11-18 22:05:49 +05:30
This integration adds commit messages as comments to Asana tasks.
2021-04-29 21:17:54 +05:30
Once enabled, commit messages are checked for Asana task URLs (for example,
`https://app.asana.com/0/123456/987654` ) or task IDs starting with `#`
(for example, `#987654` ). Every task ID found gets the commit comment added to it.
You can also close a task with a message containing: `fix #123456` .
You can use either of these words:
- `fix`
- `fixed`
- `fixes`
- `fixing`
- `close`
- `closes`
- `closed`
- `closing`
2021-11-18 22:05:49 +05:30
See also the [Asana integration API documentation ](../../../api/integrations.md#asana ).
2021-04-29 21:17:54 +05:30
## Setup
In Asana, create a Personal Access Token.
[Learn about Personal Access Tokens in Asana ](https://developers.asana.com/docs/personal-access-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-04-29 21:17:54 +05:30
1. Select **Asana** .
1. Ensure that the **Active** toggle is enabled.
1. Paste the token you generated in Asana.
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-04-29 21:17:54 +05:30
field, separated with commas.
1. Select **Save changes** or optionally select **Test settings** .
<!-- ## Troubleshooting -->
