Connect Azure Boards to GitHub
By connecting your Azure Boards project with GitHub repositories, you support linking between GitHub commits and pull requests to work items. You can use GitHub for software development while using Azure Boards to plan and track your work.
Azure Boards and GitHub integration is in Public Preview and supported only for Azure DevOps Services at this time.
- You must connect to an Azure Boards or Azure DevOps project. If you don't have a project yet, create one.
- You must be a member of the Project Administrators group and the project's Contributors group. If you created the project, then you have permissions.
- You must be an administrator or owner of the GitHub repository you'll be connecting to.
You can connect to multiple repositories so long as you are an administrator for those repositories.
Add a GitHub connection and repository
Sign into Azure Boards.
Choose (1) Project Settings, choose (2) GitHub connections and then (3) Connect your GitHub Account.
Enter your GitHub account credentials. Choose an account for which you are an administrator for the repositories you want to connect to.
If you have enabled two-factor authentication, enter the authentication code that GitHub sent you and choose Verify.
Review the GitHub authorization dialog that appears which indicates the information you'll allow Azure Boards to access from GitHub. Choose Authorize AzureBoards when ready.
In the Add GitHub repositories dialog, you'll see the list of repositories for which you are an administrator.
Check the ones that you want to add and then choose Save. When done, you should see the new connection with the selected repository listed.
We recommend that you only connect a GitHub repo to projects defined in a single Azure DevOps organization. Connecting the same GitHub repo to projects defined in two or more Azure DevOps organizations can lead to unexpected AB# mention linking. For details, see Troubleshoot GitHub & Azure Boards integration.
Add or remove repositories, or remove a connection
To add or remove repositories, open the for the connection and choose Add repositories or Remove repositories from the menu.
To remove all repositories and the connection, choose the Remove connection option. Then, choose Remove to confirm.
Use a Personal Access Token (PAT)
We recommend that you use OAuth to connect to your GitHub repository. However, if you need to use a PAT, you can by following these procedures.
When creating your GitHub PAT, make sure that you include these scopes:
repo, read:user, user:email, admin:repo_hook.
To choose a PAT when connecting a GitHub repository, choose New Connection and then choose the Click here link.
To create a GitHub PAT, go to GitHub Developer Settings>Personal access tokens.
Enter the PAT and choose Connect.
Resolve connection issues
Try this next
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.