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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aisera.com/aisera-platform/adding-data-to-your-tenant/integrations-and-data-sources/connectors/notion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.