Company Type
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
No articles found for this topic.
The Asana for GitHub integration is available on Asana Starter, Advanced, Enterprise, and Enterprise+ tiers, as well as legacy tiers Premium, Business, and Legacy Enterprise.
Visit our pricing page for more information.
With the Asana for GitHub integration, you can automatically sync GitHub pull request status updates to Asana tasks to improve cross-functional collaboration.
This integration helps raise visibility and transparency around engineering work between technical and non-technical teams. With this new integration, developers can communicate effortlessly through Asana to keep teams and cross-functional stakeholders in the know and prevent work from falling through the cracks.
This integration does not support GitHub Enterprise Server.
Connect Asana and GitHub to sync your pull request statuses. To utilize the integration, configuration is set up in Asana and for additional features, within GitHub as well.
Congratulations, you can now connect GitHub pull requests to Asana tasks. If you would like to enable additional functionalities with the integration, please review the next section. Otherwise please skip to Key functionality below.
This section assumes basic familiarity with git and GitHub repository secrets. If you do not have access to set up repository secrets, please contact the repository owner.
We support two types of GitHub Actions:
Similar to other GitHub Actions, they will only run when an event occurs in the repository you have set up the actions for. For example, you can set up an action to run every time someone merges or comments on a pull request.
Each of these GitHub Actions must be set up individually, unless there are multiple, identical actions in the same repository. For example, you can set up an action to comment on the task in the pull request description when a test is complete and another action to add a different comment to the task when the pull request is merged.
GitHub Actions can also be added as part of an existing workflow. Reference the GitHub Actions resource guide to learn more.
If you set up Github Actions in the previous section, you can revoke secret tokens. Visit this set-up page, and select Revoke all.
This will revoke all existing GitHub Actions secret tokens.
Note
You will still be able to see pull request information in the existing Asana projects where you have added this integration.
After installing the GitHub integration in Asana, you will be able to see a GitHub field on every task in the associated project.
To attach a pull request to an Asana task, retrieve the pull request URL and paste it in the empty GitHub field. A widget with the following details should now appear on the Asana task: Review status, Build state, PR status, Line changes, and conversation count within GitHub.
After installing the GitHub integration in Asana and setting up GitHub Actions, you can now automatically attach a pull request to an Asana task from a GitHub pull request description.
In your GitHub pull request description, retrieve the Asana task URL and paste it into the description. A widget with the following details should now appear when viewing the task in Asana: Review status, Build state, PR status, and Line changes.
Note
Any errors should be reflected in the GitHub Actions tab within GitHub.
Pull requests can be closed in GitHub after the appropriate teams review and merge the changes. The status in the Asana widget will automatically update.
If you would like to attach a new GitHub pull request, you can add the Asana task URL to the new GitHub pull request description and the widget will automatically be replaced or you can remove the closed pull request within Asana by clicking the menu in the top right. Once removed, you can enter in a new GitHub pull request url.
After installing the GitHub integration in Asana and setting up GitHub Actions, you will now receive comments on Asana tasks with an open pull request attached. This will include updates on whether or not the pull request has been merged or closed.
Yes
Yes. When you attach a pull request to a task, everyone who can view the task can see the information in the widget.
No, your old secret tokens will still work. If you want to disable your existing secret tokens, you can do so here.
Yes
git
says that my token does not have access to create workflows. What should I do?If you are using two-factor authentication and interacting with GitHub on the command line, GitHub requires that you use your personal access token as the password. Please create a new GitHub personal access token with the workflow scope.
We only read and write from pull requests in this integration. The permission on the authentication page is the most restrictive permission GitHub allows us to request in order to access pull requests.
An attachment that links to the pull request will be visible in the task comment section, but the widget that syncs the pull request status will not appear.
Note
Like what you see? Get started with a free Asana trial today. Try for free.
These cookies are strictly necessary to provide you with certain features. For example, these cookies allow you to access secure areas that require registration and set your privacy preferences. Because these cookies are essential to providing services to you, they cannot be disabled. You can set your browser to block or alert you about these cookies, but it may cause some parts of the site to not work.
These cookies allow us or our third-party analytics providers to collect information and statistics on use of our services by you and other visitors. This information helps us to improve our services and products for the benefit of you and others.
These cookies provide enhanced functionality, providing chat support, allowing you to more easily complete forms, personalizing content to your preferences, and selecting your communications preferences. If you do not enable these cookies, or choose to disable them in the future, that could impact your ability to use certain features.
These cookies, provided by our third-party advertising partners, collect information about your browsing habits, as well as your preferences for various features and services. They also provide us with auditing, research, and reporting to know when advertising content has been displayed and how successful the content has been. This information allows us and our third-party advertising providers to display relevant advertising content.