Hey developers! We understand how crucial it is to have a robust integration between your source code tool and monday.com, so we want to present to you the GitHub Integration.
This one-time installation integration with GitHub offers more flexibility and more powerful recipes so that your team can have a seamless software development flow, from planning and tracking sprints on monday.com to executing the perfect code on GitHub!
The new integration is an account-level-permission integration. Once the integration is pre-installed in just a few steps, any developer on your team can create new recipes. How easy is that?
Important notes
In order for the GitHub integration to sync successfully, you will first need to install the monday.com application on GitHub. You'll also need to be an Admin of your monday.com account and have Admin permission on the GitHub organization to install the application.
You'll be asked to choose an organization on your account:
You'll then be asked to authorize monday.com on your GitHub account:
Once this is installed, users can add new GitHub recipes and will automatically be authenticated with your GitHub account.
Add it to your workflow
To add the new GitHub integration recipes to your desired board, you can go to that board and click on "Integrate" in the upper right corner:
Once you're in the Integrations Center, search for "GitHub" in the search bar:
Click on the "GitHub (New Integration)" banner and you will find the recipes our integration offers:
Then you can simply select the recipes you want to add to your board.
Create a two-way sync
A two-way sync occurs when data is being both pushed from monday.com into GitHub and pulled from GitHub into monday.com. This makes it so that your data matches within both platforms and remains up-to-date.
The nature of this recipe allows you to choose the direction of your sync in order to create a two-way sync between GitHub and monday.com.
Setting up the two-way sync
When you're mapping "these fields", you will select the field in GitHub, the field in monday.com, and the direction that you want the sync to occur. To create a two-way sync, select "both ways".
For example, using the GIF below, if you want to map your item's "Owner" column on monday.com to the "Assignee" field in GitHub, you will select those fields beneath the respective company's logo. Then, under the "Choose direction" dropdown, choose "both ways" to indicate that the information will travel in both directions.
What does the "item ID" mean in some of the recipes?
Great question! Some of the integration recipes need a "unique connection" between monday.com and GitHub in order to sync the two platforms, and the item ID serves as that unique number associated with the item.
For example, let's take the integration recipe: "When a pull request is created in this repository, and item id is mentioned in the pull request name, change status to something." Once the pull request is created in GitHub, the system uses the item ID in monday.com to identify which item it needs to change.
Will the new integration work even if I don't install the application in GitHub?
No, the integration is not possible without the application being installed in GitHub.
Can I connect my monday.com account to multiple organizations in GitHub?
Yes! You can connect your monday.com accounts to multiple GitHub organizations.
How can I un-sync GitHub from monday.com?
Then, to uninstall the monday.com application from GitHub, you can go to your GitHub account > Settings > Applications and find monday.com. Scroll down to the "Danger zone" and click "Uninstall":
What will happen to the old GitHub Integration?
At this time, you can still find and use the old GitHub integration in the Integrations Center, but it will eventually be phased out as we continue to take feedback from our awesome users (that's you!) and add functionality to the new integration.
Send our team your feedback directly here, and stay tuned for more exciting updates!
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!
If you have any questions, please reach out to our team right here. We’re available 24/7 and happy to help.
Comments