***

title: Notion Access Requirements
excerpt: ''
deprecated: false
hidden: false
metadata:
title: ''
description: ''
robots: index
next:
description: ''
---------------

## 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.

## 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](https://www.notion.com/my-integrations) in browser.
2. Click the `+ New integration` button.
3. Name the integration.
4. Select the [capabilities](https://developers.notion.com/api-reference/legacy-gateways/authentication#integration-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](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.

![](https://files.readme.io/9af4208-small-d9f27cd-my_internal_integration.png)

# 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.

## Connector Setup Overview

With all the required details collected, we can now configure the connector to interact with your Notion Instance.

* Go to the *Connectors* module in Moveworks Setup, by clicking on **Manage Connectors** under **Core Platform**, and then click on **System Connectors**.
* Click on Create **New** in the top right corner.
* Search for the **Notion** System here

![](https://files.readme.io/c7de83328aefc19e1d15457f6f51689307d43bbfde224ee3c102607342822784-image.png)

* Start by providing the **Integration Token** we just generated in the config which will authenticate to the Notion instance.

![](https://files.readme.io/c0a8ca50e321f500aed039f2c130df2d43f146d9620ac770f321ce67eb21599e-image.png)

You can now go ahead and **save** the config and start using this Connector across Setup.