> For the complete documentation index, see [llms.txt](https://docs.aisera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisera.com/aisera-platform/adding-data-to-your-tenant/integrations-and-data-sources/connectors/notion.md).

# Notion

Before you create an Integration between the Aisera platform and your Notion application, use the following steps to get an Access Token that you will use with the connection.

## Prerequisites

1. Create an API token:

   a. Log in to your Notion application. \
   b. Go to your Notion **Integrations** page.\
   c. Click **Create new integration** or choose an existing one.\
   d. Copy the Notion integration's **Access Token**.\
   e. Share a database with your integration.
2. The Notion API is located here.
3. Use your access token when you set up your Integration with the Aisera platform, as described below.

### Integration Setup <a href="#h_01kavvmegp6f7hjgy5avswmsr5" id="h_01kavvmegp6f7hjgy5avswmsr5"></a>

To create the Notion integration:

1. Choose **Settings > Integrations** from the left navigation menu of the Aisera Admin UI.

<div align="left"><figure><img src="/files/6Z1ngkLgNp9bQ7FpYBRf" alt="" width="229"><figcaption></figcaption></figure></div>

2. Click on the **+ New Integration** button in the upper-right corner.

<div align="left"><figure><img src="/files/ZWGdeYjf05nfH6hYHQY8" alt="" width="563"><figcaption></figcaption></figure></div>

3. Choose **Notion** from the Integration options.

<div align="left"><figure><img src="/files/10wQqjv7VK8478CCNjp5" alt="" width="339"><figcaption></figcaption></figure></div>

4. Provide a **Name** and the endpoint for your Notion application and click **Next**.

<div align="left"><figure><img src="/files/WrZGVyCKHqNVW1G74BVI" alt="" width="375"><figcaption></figcaption></figure></div>

5. Enter the **Notion Access Token** that you received in the **Prerequisite** section.

<div align="left"><figure><img src="/files/1aCk3ODPKMnOIYhZDHzE" alt="" width="375"><figcaption></figcaption></figure></div>

Enter the **Username** and **Password** of the Service User or Admin who has permission to access your Notion data.

Click **OK**. The success message appears when the integration is successful.&#x20;

<div align="left"><figure><img src="/files/WH4JRFsQ43L2OENpyDlD" alt="" width="351"><figcaption></figcaption></figure></div>

### Data Source Setup <a href="#h_01kavz8myqjne9x4v6d0v6wg85" id="h_01kavz8myqjne9x4v6d0v6wg85"></a>

After configuring your Notion integration, configure your Notion Data Source.

To create a Notion data source:

1. Choose **Settings > Data Sources** from the left navigation menu of your Aisera Admin UI.
2. Choose **+ New Data Source** in the upper-right corner.

<div align="left"><figure><img src="/files/bzYpHF0gGZlnXU3VCxWv" alt="" width="563"><figcaption></figcaption></figure></div>

2. Type **Notion** in the Search field and Select the **Notion icon**.

<div align="left"><figure><img src="/files/o9RaN0Gu2SC7mDtoYRRQ" alt="" width="375"><figcaption></figcaption></figure></div>

3. Click **Next**.
4. Enter a **Name** for your Data Source.

<div align="left"><figure><img src="/files/doXlHCU4ABXUu5KFaGgL" alt="" width="563"><figcaption></figcaption></figure></div>

5. Choose the **Functions** that you want your data source to support. As you choose Functions, the dialog window will expand to give you more options. For most use cases, you can choose **Knowledge Base Learning**.

<div align="left"><figure><img src="/files/aKlsARtXLvdyRAKjNuzc" alt="" width="375"><figcaption></figcaption></figure></div>

5. Choose your Notion Integration from the Integration pull-down list.
6. If you plan to use [**Event Triggers**](https://docs.aisera.com/aisera-platform/ai-automation-optimize-flow/event-studio#complete-the-following-steps-to-create-the-event-trigger), create or choose a [**Data Type**](https://docs.aisera.com/aisera-platform/ai-automation-optimize-flow/event-studio#complete-the-following-steps-to-define-a-data-type) for the Triggers before you continue. Then choose that Data Type from the Data Types pull-down list on this page.
7. Select **On Demand** for the **Schedule** field.&#x20;
8. Click **Next**.
9. The parameters on Step 3 are optional. If you're using an Event Type, you can add it here.

<div align="left"><figure><img src="/files/rV1jrXykJywANdmncE6G" alt="" width="563"><figcaption></figcaption></figure></div>

10. Step 4 allows you to add Templates for your Knowledge Articles are also optional.

<div align="left"><figure><img src="/files/1xUPfraxWA0NbVRc466C" alt="" width="563"><figcaption></figcaption></figure></div>

10. Click **Next**.
11. Keep the default parameters for Step 5, as shown below.

<div align="left"><figure><img src="/files/gIYxyeFuW6aCDzkelpXk" alt="" width="563"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/K0Lm7SSYkOWvq4iUQfuk" alt="" width="563"><figcaption></figcaption></figure></div>

10. Click **Next**.
11. Add code for any over-rides or transformations. Your Aisera Team can help you with the format for these.

<div align="left"><figure><img src="/files/FY0qrkubfvz0YvQmxxUt" alt="" width="375"><figcaption></figcaption></figure></div>

10. Click **OK**.

When you see the green success message at the top of your window for a pre-mapped connector, the data from each field is being ingested into your Aisera platform. Open the **Data Source Details** window to see the [**mapped fields**](https://docs.aisera.com/aisera-platform/adding-data-to-your-tenant/data-ingestion#field-mapping).