> ## Documentation Index
> Fetch the complete documentation index at: https://serval-hannah-docs-custom-access.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

## About Notion

Notion is an all-in-one workspace platform that combines notes, databases, kanban boards, and documents. Connecting Notion to Serval enables automated documentation management, database operations, and content workflows directly from your service desk.

## What the Notion integration enables

| Capability           | Description                                                                        |
| -------------------- | ---------------------------------------------------------------------------------- |
| Automation workflows | Create pages from templates, update database entries, manage blocks, and more      |
| Knowledge Sync       | Pull documentation for context-aware answers and relevant document recommendations |

Anything defined in the [Notion API](https://developers.notion.com/reference/intro) can be accessed through Serval.

***

## Notion Configuration

### Prerequisites

* You must be a Workspace Owner or have admin permissions to create integrations
* Decide which pages and databases Serval should have access to

### Create an Internal Integration

1. Navigate to [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations)
2. Click **+ New integration**
3. Configure your integration:
   * **Name**: Enter "Serval Integration" or another descriptive name
   * **Associated workspace**: Select your workspace
   * **Capabilities**: Choose the permissions Serval needs:
     * Read content
     * Update content
     * Insert content (if creating new pages/blocks)
     * Read comments (optional)
     * Read user information (optional)
4. Click **Submit** to create the integration
5. Copy the **Internal Integration Token** (starts with `secret_`)

### Grant Integration Access to Pages/Databases

After creating the integration, you must explicitly grant it access to specific pages or databases:

1. Open the Notion page or database you want Serval to access
2. Click the **•••** menu in the top right
3. Select **Add connections**
4. Search for and select your integration (e.g., "Serval Integration")
5. Click **Confirm**

> **Note**: Integrations only have access to pages they've been explicitly shared with. Child pages inherit permissions from their parent pages.

***

## Serval Configuration

1. In Serval go to **Apps → Available → Notion → Connect**

2. Enter the following information:

   | Field            | Description                                                        |
   | ---------------- | ------------------------------------------------------------------ |
   | Integration Name | A friendly name for this integration (e.g., "Engineering Wiki")    |
   | API Token        | The Internal Integration Token from Notion (starts with `secret_`) |

3. Click **Save**

***

Need help? Contact **[support@serval.com](mailto:support@serval.com)** for assistance with your Notion integration.