> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect Notion to xpander and give agents its 19 actions: how to sign in and connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://api.notion.com/v1` and carry an OAuth 2.0 token obtained with **Sign in with Notion** on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

## What the skill can do

API connector: 19 actions, as they appear in the skill panel. 10 of them create, change or delete something in Notion; mark those under **These actions need approval** when you add the skill to an agent.

* **Block content management** (5): Blocks Retrieve Block By Id, Blocks Delete Block By Id, Blocks Update Block Content, Blocks List Child Blocks, Blocks Append Child Blocks
* **Page and workspace management** (5): Create New Page In Workspace, Retrieve Page By Id, Update Or Archive Page By Id, Properties Retrieve Property Item By Id, Content Search Search Pages And Databases
* **Database structure management** (4): Create New Database, Retrieve Database By Id, Update Database By Id, Query Query Database Entries By Id
* **User and bot management** (3): List All Users In Workspace, Retrieve Bot User Details, Retrieve User By Id
* **Comment discussion management** (2): Retrieve Unresolved Comments, Collaborative Interaction Add Comment To Discussion

## Authentication Options

<Tabs>
  <Tab title="Built-in xpander Auth">
    The simplest way to connect Notion is by using xpander's built-in authentication:

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Notion** and select it.
    3. Click **Sign in with Notion**.
    4. Grant xpander permission to access your Notion workspace.
    5. Your Notion integration is now ready to use.
  </Tab>

  <Tab title="API Access">
    ### Generate a Notion API Key

    1. Log in to your [Notion Integrations dashboard](https://www.notion.so/profile/integrations) and click **New Integration**.

           <img src="https://mintcdn.com/xpanderai-099931d1/MfbW8wufR8EyGOUW/images/connectors/notion/img_1.png?fit=max&auto=format&n=MfbW8wufR8EyGOUW&q=85&s=adb8f2903f6df40fecc67addb4c49eb0" alt="Img 1" width="2861" height="1444" data-path="images/connectors/notion/img_1.png" />

    2. Under **Associated workspace**, choose your Notion workspace.\
       Under **Type**, select **Internal**.

           <img src="https://mintcdn.com/xpanderai-099931d1/MfbW8wufR8EyGOUW/images/connectors/notion/img_2.png?fit=max&auto=format&n=MfbW8wufR8EyGOUW&q=85&s=6b5f4fb2e113b7663fdbac1c018383ef" alt="Img 2" width="2866" height="1708" data-path="images/connectors/notion/img_2.png" />

    3. After clicking **Save**, you'll see your Notion API key under the **Internal Integration Secret** section.

    ### Connect Notion in xpander

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Notion** and select it.
    3. Click **Other auth options**.
    4. Enter a **connection name**, e.g., "xpander-notion".
    5. Choose **Organization** access (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](/use/agents/permissions#whose-credential-a-shared-agent-uses).
    6. Select **API Key** as the authentication method.
    7. Paste the Notion API key into the provided field.
    8. Set the **Type** to **Bearer**.
    9. Click **Connect**.
  </Tab>
</Tabs>

## Give an agent the Notion skill

Once Notion is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Notion**. The skill panel lists the Notion actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Skills](/use/skills)
* [Notion API Documentation](https://developers.notion.com/reference/intro)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.