What can we help you with?

GitHub Integration

Screen_Shot_2020-03-11_at_16.27.35.png

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

To add an Integration, go to the board you want to create an Integration for and click on the Integration button, located on the upper right of your screen. 
 
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."
 
 
integration.png 

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

integrations.png

Step 2

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

Screen_Shot_2019-01-09_at_7.24_1.png

Step 3

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

  • When an item is created, create an issue in this repository. x
  • When a status changes to something, create an issue in this repository
  • When a comment is created on an issue of this repository, create an update in the connected item.
  • When tagging a commit in this repository, create an item with this prefix.
  • When pull request is opened in repository, create an item and sync future changes from GitHub.
  • When an item ID is mentioned in commit to this repository, create an update to the relevant item. 
  • When pushed to master branch of this repository, create an item.
  • When an issue is created in this repository, create an item an sync future changes from GitHub.
  • When pushed to master branch of this repository, create an update in this item.

 

Step 4

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

image_2.png

 

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.

1_1.png

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 an item is created, create an issue in this repository" to your board. 

GitHub_Repository_Recipe__1_.png

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

1_1.png

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

2_1.png

 

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

 

More assistance

If you need help building custom integrations, we also have an option for paid assistance through our network of certified monday.com partners. If you're interested, please fill out this form and someone will be in touch shortly! 

 

And if you have any questions about this or anything else in this article, feel free to reach out to us at customer success at [email protected]