Sync GitHub Issues to Notion Database

This n8n workflow automates the process of syncing new GitHub issues to a Notion database, ensuring your project management tools are always up-to-date.

What it does

This workflow simplifies issue tracking by automatically:

1. Listening for GitHub Issue Events: It triggers whenever a new issue is opened in a specified GitHub repository.
2. Processing Issue Data: It extracts relevant information from the GitHub issue.
3. Filtering Events: It checks if the GitHub event is an issues event, specifically when an issue is opened.
4. Creating Notion Database Entries: If the conditions are met, it creates a new page in your designated Notion database, populating it with the GitHub issue's title, URL, and other details.

Prerequisites/Requirements

• n8n Account: An active n8n instance (cloud or self-hosted).
• GitHub Account: A GitHub account with access to the repository you want to monitor.
• Notion Account: A Notion account with a database set up to store your GitHub issues.
  • You will need to create a Notion integration and grant it access to your database.
  • Ensure your Notion database has properties to store at least the issue title and URL (e.g., a "Title" property and a "URL" property).

Setup/Usage

1. Import the workflow:
   • Download the provided JSON file.
   • In your n8n instance, click "New" in the top left, then "Import from JSON".
   • Paste the JSON content or upload the file.
2. Configure GitHub Trigger:
   • Click on the "Github Trigger" node.
   • Credentials: Select or create a new GitHub OAuth2 API credential. You will need to authorize n8n to access your GitHub account.
   • Events: Ensure "Issues" is selected under "Events to Listen For".
   • Repository: Specify the GitHub repository you want to monitor (e.g., your-username/your-repo).
   • Webhook URL: n8n will provide a webhook URL. You will need to add this URL to your GitHub repository's webhooks settings. Go to your GitHub repository -> Settings -> Webhooks -> Add webhook. Paste the URL, set "Content type" to application/json, and select "Let me select individual events" and check "Issues".
3. Configure Notion Node:
   • Click on the "Notion" node.
   • Credentials: Select or create a new Notion API credential. You will need to create an internal integration in Notion and grant it access to your database.
   • Database ID: Enter the ID of your Notion database where issues will be synced. You can find this in the URL of your Notion database (e.g., https://www.notion.so/{workspace_name}/{database_id}?v={view_id}).
   • Properties: Map the GitHub issue data to your Notion database properties. For example:
     • Title: {{ $json.issue.title }}
     • URL: {{ $json.issue.html_url }}
     • You can add more properties as needed (e.g., {{ $json.issue.state }} for status, {{ $json.issue.user.login }} for assignee, etc.).
4. Activate the workflow:
   • Once all credentials and settings are configured, click the "Activate" toggle in the top right of the n8n editor to start the workflow.

Now, whenever a new issue is opened in your specified GitHub repository, it will automatically be added as a new page in your Notion database!