https://github.com/alessandrobelli/notionhook

Sync your GitHub commits into a Notion Database
https://github.com/alessandrobelli/notionhook

github-actions notion

Last synced: about 1 month ago
JSON representation

Sync your GitHub commits into a Notion Database

• Host: GitHub
• URL: https://github.com/alessandrobelli/notionhook
• Owner: alessandrobelli
• License: mit
• Created: 2021-07-25T09:55:10.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-06-29T11:16:58.000Z (over 2 years ago)
• Last Synced: 2024-04-23T17:24:49.806Z (8 months ago)
• Topics: github-actions, notion
• Language: JavaScript
• Homepage:
• Size: 1.87 MB
• Stars: 32
• Watchers: 2
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Notion Hook

This action syncronize your Repository commits into a Notion Database.

📽️ Video Explanation: https://youtu.be/hARJlFH5MDE

## Setup

1. Create a new private Notion integration here: https://www.notion.so/my-integrations.

2. Copy the "Internal Integration Token" and create a new Repository secret called `NOTION_SECRET`.

3. [You need to create a new Notion Database that looks like this, or just duplicate this](https://alessandrobelli.notion.site/618655fb8e924216a5bc8b85cfd12274?v=eda6bbef2108493c9f1c0f9772a58549).

4. Click on Share -> Add people, emails, groups or integrations and select your Integration.

5. Navigate to your Notion database in a browser and get the Database Id.

![Database ID example](https://user-images.githubusercontent.com/3796324/126894870-e81d2831-9ac2-404a-bc07-a2d9d4014a39.png)

6. Create a new secret called `NOTION_DATABASE` with the database ID.

7. if you want a list of files, [create a github personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token).

   1. then setup a files-format. the only avaliable value for now is "text-list".

## Inputs

Every input has its own default value. Check if they correspond to yours in the database.

### `commit_description`

**text**

Name of the Database column for the description field: this is the commit message after a `\n` or `\r`.

### `commit_url`

**url**

Name of the Database column for the commit url.

### `commit_id`

**Text**

Name of the Database column for the commit ID.

### `commit_project`

**Multiselect**

Name of the Database column for the project. 

### `files_format`

For now, the only possible value text-list.

### `token`

[Create a github personal access token for GitHub](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)

## Example usage

```

on: [push]

jobs:

  Notion_Hook_job:

    runs-on: ubuntu-latest

    name: A job to connect to Notion

    steps:

      - name: Connect to Notion step

        id: notion

        uses: alessandrobelli/[email protected]

        with:

          notion_secret: ${{ secrets.NOTION_SECRET }}

          notion_database: ${{ secrets.NOTION_DATABASE }}

```