Skip to main content

Notion Setup Guide

Prerequisites

  • Access to a Notion workspace

Setup Guide

To authenticate the Notion source connector, you need to use one of the following two methods:

  • OAuth2.0 authorization

  • Access Token

    ℹ️ We recommend using OAuth2.0 authorization for connecting to Notion, as this method significantly simplifies the setup process. With OAuth 2.0 authorization, there's no need to create and configure a new integration in Notion separately. You can directly proceed to configuring the connector (Step 2).

Step 1: Create and Configure a New Notion Integration - Access Token Only

  1. Log in to your Notion workspace and go to the My integrations page. Click on "New integration.". NOTE To create a new integration associated with your workspace, you must be the owner of the Notion workspace.

  2. Provide a Name for your integration. Ensure that you've chosen the correct workspace from the Associated workspace dropdown menu, and click Submit.

  3. Copy and save your Internal Integration Secret - you will need it to configure your connection.

  4. Navigate to the Access Tab of your integration and select the page(s) the token will have access to.

  5. Navigate to the navbar and select Capabilities. Depending on your requirements, check the following capabilities:

Step 2: Complete Configuration in Matia

  1. In the Notion App, navigate to the page(s) you want to share with Matia. Click the ••• menu at the top right of the page, select Add connections, and choose the integration you created earlier.
  2. In Matia, authenticate with OAuth by clicking on Sign In With Notion or enter your Access Token
  3. Enter an Asset Name.
  4. (Optional) Enter a Description.
  5. (Optional) Assign Tags.
  6. Select an Owner.
  7. Verify that your Notion account is successfully connected by clicking on Test Connection.
  8. Click Connect.

Supported Streams

This connector outputs the following streams:

  • Page (Full Refresh, Incremental)
  • Database (Full Refresh, Incremental)
  • User (Full Refresh, Incremental)
  • Comment (Full Refresh)
  • Block (Full Refresh)