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.