Skip to content
Fp Switchboard

Notion Integration Setup

Create a Notion integration to access pages, databases, and blocks.

Setup Steps

Section titled “Setup Steps”

  1. Create a Notion Integration

    Go to My Integrations and click “New integration”.

  2. Configure Integration Settings

    • Name: Fp Switchboard
    • Associated workspace: Select your workspace
    • Type: Select “Public” for OAuth integration

  3. Set Capabilities

    Enable the following capabilities:

    • Read content
    • Update content
    • Insert content
    • Read comments
    • Create comments
    • Read user information

  4. Configure OAuth Settings

    In the OAuth & redirect URIs section, add the redirect URI:

    https://api.switchboard.fpdigital.ai/oauth/notion/callback

  5. Get OAuth Credentials

    Copy the OAuth Client ID and OAuth Client Secret from the Secrets section.

  6. Submit for Review (Optional)

    For public distribution, submit your integration for Notion review. For internal use only, this is not required.

Environment Variables

Section titled “Environment Variables”
Terminal window
npx wrangler secret put NOTION_CLIENT_ID
npx wrangler secret put NOTION_CLIENT_SECRET
VariableDescription
NOTION_CLIENT_IDOAuth Client ID from Notion Integration settings
NOTION_CLIENT_SECRETOAuth Client Secret from Notion Integration settings

Redirect URI

Section titled “Redirect URI”
https://api.switchboard.fpdigital.ai/oauth/notion/callback

Important Notes

Section titled “Important Notes”
  • Nested blocks are limited to 2 levels via the API
  • Notion tokens don’t expire unless the user revokes access
  • Database queries support filtering and sorting