notion-github-action

Notion x GitHub Action

Connect your GitHub issues to a Notion database.

Like this GitHub Action? Give us a ⭐️ and follow us on Twitter for more drops 🪂.

Quick Start

• Create a new internal Notion integration and note the value of the Internal Integration Token.
• In your GitHub repository, go to Settings > Secrets, and add a New repository secret. Set the Name to NOTION_TOKEN and the Value to the Internal Integration Token you created in the previous step.
• Set up your Notion Database. Use this template and duplicate it to your workspace.
• In your Notion Database page's Share menu, add the Notion integration you created as a member with the Can edit privilege. You may have to type your integration's name in the Invite field.
• Find the ID of your Database by copying the link to it. The link will have the format

https://www.notion.so/abc?v=123

where abc is the database id.

• Add the Database's ID as a repository secret for your GitHub repository. Set the Name to NOTION_DATABASE and the Value to the id of your Database.

• In your GitHub repository, create a GitHub workflow file at the path .github/workflows/issues-notion-sync.yml.

on:
  issues:
    types: [opened, edited, labeled, unlabeled, assigned, unassigned, milestoned, demilestoned, reopened, closed]

jobs:
  notion_job:
    runs-on: ubuntu-latest
    name: Add GitHub Issues to Notion
    steps:
      - name: Add GitHub Issues to Notion
        uses: instantish/notion-github-action@v1.1.0
        with:
          notion-token: ${{ secrets.NOTION_TOKEN }}
          notion-db: ${{ secrets.NOTION_DATABASE }}

Built with 💙 by the team behind Fabric.