https://github.com/dmolitor/notionr

Minimal client for Notion API (beta)
https://github.com/dmolitor/notionr

notion notion-api r r-stats

Last synced: 2 months ago
JSON representation

Minimal client for Notion API (beta)

• Host: GitHub
• URL: https://github.com/dmolitor/notionr
• Owner: dmolitor
• License: mit
• Created: 2021-05-27T18:06:06.000Z (over 4 years ago)
• Default Branch: trunk
• Last Pushed: 2021-11-02T22:16:19.000Z (about 4 years ago)
• Last Synced: 2025-09-07T21:31:56.832Z (3 months ago)
• Topics: notion, notion-api, r, r-stats
• Language: R
• Homepage: https://dmolitor.github.io/notionr/
• Size: 204 KB
• Stars: 5
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)

[![R-CMD-check](https://github.com/dmolitor/notionr/workflows/R-CMD-check/badge.svg)](https://github.com/dmolitor/notionr/actions)

# notionr

Minimal client to access the [Notion API (Beta)](https://developers.notion.com/docs/getting-started).

## Installation

Get the development version from github with:

```r

# install.packages("devtools")

devtools::install_github("dmolitor/notionr")

```

## ⚠️ Warning ⚠️

The Notion API is under rapid development and this package isn't. It currently covers ~75% of the API functionality,

but none of the `PATCH` or `DELETE` methods have been implemented. Additionally, since the API is in beta, some changes

in its functionality may break existing functionality in this package. However, this should provide a solid base of 

functionality that can easily be extended and improved on.

## Setup

- **notionr**

    To start the OAuth flow to verify to Notion that you would like the notionr integration to have access to your workspace:

    

    ``` r

    notion_auth()

    #> Waiting for authentication in browser...

    #> Press Esc/Ctrl + C to abort

    #> Authentication complete.

    #> Access credentials have been stored at ~/.R/notionr/oauth/workspace-name/notionr_oauth_access.json

    ```

    

    Then, access the authorization token:

    

    ```r

    key <- cached_access_code()

    key

    #> [1] "secret_eolsOUT1yhjncXdT0wLBz74i3MGDXAe6P**********"

    ```

- **Internal Integration**

    Alternatively, if you want to create an internal integration, go to [your integrations](https://www.notion.so/my-integrations/)

    and create a new internal integration. From within the integration dashboard you can copy your authorization token and

    store it as desired.

    

- **Public Integration**

    notionr is not yet set up to accomodate a public integration.