How to integrate GitHub with Notion: Step-by-step tutorial with a free template

welcome to this step-by-step tutorial on how to create gith Hut notion integration using Nan a source available workflow automation tool by the end of this tutorial you'll be able to create a seamless workflow that automatically syncs gith Hub issues with notion database Pages whenever a new issue is opened in your GitHub repository it will show up in your notion database existing issues are synchronized the title is updated the status changes automatically whenever an issue is closed reopened or deleted each published NN template can be copy pasted directly into the editor you will find a link to the template for this tutorial in the description below the video you can pause the video and come back to it when you're ready to continue before we begin please make sure you have the following a GitHub account with an oo app or an access token a notion account with an API key finally a notion database with four columns so let's get started first open n in your web browser and add a new workflow in this tutorial we will create a GitHub notion integration from scratch select the GitHub trigger from the list this will be the first workflow node in the new window provide your GitHub credentials if you are using this node for the first time click on the docs Link in the new window click the credentials link again and follow the instructions after that provide the repository details owner and repository Fields make sure you select issues as the event to trigger the workflow close the configuration window and click the save button pick the if node add a new string condition in the value one field select expression and provide the following snippet this Json object indicates if the new GitHub issue was created or an ex existing one was modified now type opened in the value 2 field whenever the workflow is activated by GitHub trigger the if node will route an incoming message into the true or false Branch let's configure the true Branch coming from an if node select a notion node that creates a new database page and enter your notion credentials a separate database was created for this tutorial your workflow will have a different database ID you can also provide a no database URL if this is more convenient for you please take the time to create a new notion page with a database configure the database columns copy the new database URL and return to the tutorial now we need to provide a title and ID number of the new GitHub issue click on the add property button select the first column name from the drop- down list drag and drop a Json key into the empty field under the issue ID repeat the process for the URL column click on ADD property once again select the column click on the Json key Drive the element into an empty field and release the mouse button close the configuration window save the workflow and click on the execute button now let's try adding a new GitHub issue great your GitHub notion integration adds a new issue let's Now work on a second branch of the workflow we need to ensure that existing GitHub issues are properly synchronized add the code node to the canvas and connect it to the false branch of the if node copy the JavaScript code into the editor you can take this code from the workflow template Linked In the description below the video this code creates a dynamic notion filter based on the existing GitHub issue ID close the config window and save the workflow now let's apply this filter and select the existing GitHub issue in the notion database add a new notion node select database page resource and to get many operation specify the database IDs or URL and create a Json filter this is a dynamic filter that returns an ID of the existing GitHub issue now your workflow correctly selects an existing issue from the notion database before we proceed to The Next Step please make sure to hit the like button subscribe to the channel and enable notifications for all future videos we regularly release new content so stay tuned once we selected an existing GitHub issue we need to split the flow again for each action add the switch node to the canvas and configure it to handle different issue actions edited deleted closed and reopened from now on we will speed up a little connect each output of the switch node to the corresponding notion nodes for editing archiving closing or reopening issues each node is already preconfigured in the workflow template you only need to provide your notion credential cials and a valid database

URL check out links in the description below once you are done click on the save button activate the workflow by toggling the switch in the upper right corner of the editor we can add a new issue type the issue title fill in some details and hit the submit button after a few seconds you will see a new row in the notion database now let's rename the issue no new row was created in the notion database but the title of the existing issue was changed we can also try to close the issue you can see that the notion checklist field has changed finally let's delete an issue navigate to the issue scroll down and click on the delete button congratulations you've successfully created a workflow that integrates notion and GitHub using Nan whenever an issue is opened edited closed or reopened on your GitHub repository the corresponding changes will be automatically reflected in your notion database Pages if you have any questions please leave a comment below the video also let us know about other Integrations you would like to see on this channel that's only one workflow example but you can build so much more use cases for GI hup notion integration Nan is absolutely a great tool for complex workflows so don't forget to check out the links in the description below see you next time