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

# API Token

> Connect Parable to Notion using an internal connection

export const platform_1 = "Notion"

export const limit_0 = "3 requests/second average with bursts allowed"

export const platform_0 = "Notion"

export const role_0 = undefined

export const tokenName_0 = "token"

<Tabs>
  <Tab title="Setup">
    <Card title="What You'll Need" icon="key">
      | Credential | What it is                |
      | ---------- | ------------------------- |
      | **Token**  | Internal connection token |
    </Card>

    ## Overview

    Connect Parable to Notion via an internal connection for access to pages, databases, and workspace data.

    <CardGroup cols={2}>
      <Card title="Pages & Databases" icon="file-lines">
        Page content, database records, properties
      </Card>

      <Card title="Users" icon="users">
        Workspace members and collaborators
      </Card>
    </CardGroup>

    ## Prerequisites

    <Info>
      **Setup access in {platform_0}.** These steps require **{role_0}**, or a colleague with equivalent permissions who can create credentials for you.

      If that is not you, ask your {platform_0} administrator.
    </Info>

    * **Workspace Owner** or **Admin** role
    * Pages/databases must be explicitly shared with the connection

    ## Setup Guide

    <Steps>
      <Step title="Create Connection">
        1. Go to <a href="https://www.notion.so/profile/integrations/internal" target="_blank" rel="noopener noreferrer">Notion Creator Dashboard</a>
        2. Click **Create a new connection**
        3. Fill in:

        | Field                | Value                                                     |
        | -------------------- | --------------------------------------------------------- |
        | Name                 | `Parable` (Notion rejects names containing "Integration") |
        | Associated workspace | Select your workspace                                     |
        | Logo                 | Optional                                                  |
        | Type                 | Internal                                                  |
      </Step>

      <Step title="Configure Capabilities">
        Under **Configuration** > **Capabilities**, enable:

        | Capability            | Setting             |
        | --------------------- | ------------------- |
        | Read content          | ✅                   |
        | Update content        | ❌ (not needed)      |
        | Insert content        | ❌ (not needed)      |
        | Read comments         | ✅                   |
        | Read user information | ✅ (including email) |
      </Step>

      <Step title="Copy Token">
        1. Click **Show** next to the internal integration secret
        2. Copy the token

        <Warning>
          **Copy your {tokenName_0} now!**

          This is the only time it will be displayed. Store it in a secure password manager before closing this page.
        </Warning>
      </Step>

      <Step title="Share Content with Connection">
        The connection can only access pages and databases you explicitly share with it. You need to share each top-level page or database that contains data you want Parable to sync.

        For each top-level page or database:

        1. Open it in Notion
        2. Click **•••** (three dots) menu in the top right
        3. Click **Add connections**
        4. Search for and select **Parable**

        <Tip>
          Child pages automatically inherit access from their parent. Share at the highest level that covers the content you need -- for example, sharing a team workspace page gives the connection access to all pages nested underneath it.
        </Tip>

        <Warning>
          Any page or database not explicitly shared (or nested under a shared parent) will be invisible to the connection.
        </Warning>
      </Step>

      <Step title="Enter values in the form">
        1. **Token**: Paste your Notion internal connection token.
        2. Click **Save & test connection**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Reference">
    ## Verify Your Setup

    <CodeGroup>
      ```bash List Users theme={null}
      curl -X GET "https://api.notion.com/v1/users" \
        -H "Authorization: Bearer YOUR_TOKEN" \
        -H "Notion-Version: 2026-03-11"
      ```

      ```bash Search Content theme={null}
      curl -X POST "https://api.notion.com/v1/search" \
        -H "Authorization: Bearer YOUR_TOKEN" \
        -H "Notion-Version: 2026-03-11" \
        -H "Content-Type: application/json" \
        -d '{"page_size": 5}'
      ```
    </CodeGroup>

    <Check>
      **Success!** If you received a `200 OK` response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.
    </Check>

    <Tip>
      **Rate Limits:** {platform_1} enforces rate limits of **{limit_0}**.

      Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.
    </Tip>

    ## Troubleshooting

    | Error                 | Meaning                   | Solution                                          |
    | --------------------- | ------------------------- | ------------------------------------------------- |
    | `unauthorized`        | Invalid token             | Verify token is correct                           |
    | `object_not_found`    | No access to object       | Share the page/database with the connection       |
    | `restricted_resource` | Insufficient capabilities | Enable required capability in connection settings |
    | `rate_limited`        | Too many requests         | Implement backoff                                 |

    <Accordion title="Common Issues">
      ### Connection can't find pages

      Content must be explicitly shared with the connection. Go to the page → **•••** → **Add connections** → select **Parable**.

      ### Missing user emails

      Ensure **Read user information including email addresses** is enabled in connection capabilities.
    </Accordion>

    ## Additional Resources

    <CardGroup cols={2}>
      <Card title="Notion API" icon="book" href="https://developers.notion.com/reference">
        Official API reference
      </Card>

      <Card title="Integration Guide" icon="key" href="https://developers.notion.com/docs/getting-started">
        Getting started guide
      </Card>
    </CardGroup>
  </Tab>
</Tabs>