GitHub is a version control platform that allows you to track changes to your codebase, flag bugs and issues for follow-up, and manage your product's build process. 

With the monday.com integration with GitHub, you can supercharge GitHub's task-management capabilities and discuss builds with your team before they enter your codebase 👍🏽 

Adding the integration to your workflow

Step 1

Note: Only the admin of the Github account will have access to set up the integration. In order to integrate with Github, the Github permissions need to be set to "no restrictions" under the "Third-party application access policy."

 

Once you've opened the integrations page, you'll see all the wonderful apps we integrate with :) Go ahead and click "GitHub".

Step 2

Connect your GitHub account by clicking "Connect to GitHub" and then logging in with your GitHub credentials. 

Step 3

Select the integration you want to add to your board. The GitHub actions supported by monday.com are:

• When tagging a commit in this repository, create a pulse in this group with this prefix.
• When a new pull request is opened in repository, create a pulse in group.
• When a pulse ID is mentioned in a commit in this repository, create an update to the relevant pulse. 
• When push to master branch of repository, create pulse in group.
• When issue created in this repository, create a pulse in this group. 
• When a new pulse is created, create an issue in this repository. 

Step 4

When setting your integration, you can select which data will be mapped into each column:

 

Github Integration column

When selecting which data will be mapped into each column, the integration column will be added automatically with the tip that will explain the column purpose, to maintain the connection between the parameters in both apps. 

     

Note: Want more ideas for how to automate and integrate monday.com with other platforms? Check out this article: monday.com Automations

 

Supported Columns and Fields

Below you will find the supported fields for commit, pull requests, tags and issues.

Additionally, you can integrate with both public and private repositories. You must be an admin of the private repository in order to integrate it with monday.com. 

Use Case

• Using monday.com to log Github Issues

With the GitHub integration, you can supercharge your Sprint Planning board by syncing it with your codebase in GitHub! This way, you can communicate about specific issues in monday.com while still having them tracked in GitHub for easy access. 

First, add the "When a new pulse is created, create an issue in this repository" to your board. 

Then, set up a Sprint Planning board with each pulse as a bug or feature that your team is working on. 

As you add more tasks to your team's sprints, they will also appear in GitHub!

Note: When adding the Item ID to a commit, the item ID must be mentioned as a hashtag, like #123456.