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:

Note:  Our "old" GitHub integration will still be in the Integrations Center, so you'll need to scroll past that one and click on "GitHub (New Integration)" under the Apps section instead.

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.

The integration recipes supported by monday.com are:

• When an issue is labeled with something in this repository, create an item
• When a pull request is merged in these repositories, and item id is mentioned in it, change status to something
• When an issue is created in these repositories, create an item
• When a pull request is created in these repositories, and item id is mentioned in it, change status to something
• When a pull request is created in these repositories, and item id is mentioned in it, add pull request link to link column
• When a branch is created in these repositories, create an item
• When an issue status changes to something in these repositories, and item id is mentioned in it, set status to something
• When github user pushes a TODO comment to these repositories, create an item
• When an issue is created in these repositories, and item id is mentioned in it, add link to this link column
• When a pull request status changes to something in these repositories, and item id is mentioned in it, set status to something
• When an issue is labeled with something in this repository, and item id is mentioned in it, set status to something
• When a pull request status changes to something in these repositories, and item id is mentioned in it, create an update
• When a pull request is labeled with something in this repository, and item id is mentioned in it, set status to something
• When an issue is created in these repositories, create an item and sync future changes
• When an issue is created with these labels in this repository, create an item and sync future changes

Tip: With the new GitHub integration recipes, you can select multiple GitHub repositories in one recipe. No need to create multiple integration recipes for each repository! 🥳

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.

You will need to add the Item ID column from the Column Center and add it to your board before configuring these recipes.

Note: You must put a "#" symbol in front of the number in GitHub in order for the monday.com Item ID Column to recognize the connection. Ex: It must read "#376479" in GitHub, not "376479". 

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.

Tip: You can click once on the Item ID column to easily copy the value automatically from your board.

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? 

At this time, only one monday.com account can be synced to one GitHub organization.

How can I un-sync GitHub from monday.com?

To uninstall the GitHub application from monday.com, you can go to your Admin > Apps section, scroll down until you see GitHub App, and click "Uninstall": 

 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!