Notion Access Requirements

Why do we need access to Notion pages

The integration will be used by the bot to fetch all the pages and ingest the knowledge present in it and serve the end-users.

Setup Overview

After setup is complete, provide the following information to your Moveworks CS team:

→ API key

👉🏻 Provide provide ALL of the above to your Moveworks Customer Success Engineer via encrypted email.

How to setup a new integration

A Notion integration connects information in Notion to other software. To create a new integration:

  1. Visit https://www.notion.com/my-integrations in browser.
  2. Click the + New integration button.
  3. Name the integration.
  4. Select the capabilities that new integration will have.
  5. Click Submit to create the integration.

On the next page, Notion integration token can be found, also called an API key. You’ll need this token to make requests to the Notion API. To retrieve token after leaving this page, return to https://www.notion.so/my-integrations and click View integration.

Authentication Requirements

We would require the Internal integration token generated for this new integration, It can be picked from the My integration tab.

Exposing pages to the new integration

You can add new workspace/pages to an existing or newly created integration. This can be done by the admin of the workspace.

To keep your information secure, integrations don't have access to any pages or databases in the workspace at first. 

You must share specific pages with an integration in order for the API to access those pages.

To share a database/page with your integration:

  1. Go to the database/page in your workspace.
  2. Click the ••on the top right corner of the page.
  3. At the bottom of the pop-up, click Add connections.
  4. Search for and select your integration in the Search for connections... menu.

Your integration now has access to the database/page.