Notion Integration Setup

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

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.

   Caution

   Public integrations require Notion approval before they can be used by other workspaces.

Environment Variables

npx wrangler secret put NOTION_CLIENT_ID
npx wrangler secret put NOTION_CLIENT_SECRET

Variable	Description
NOTION_CLIENT_ID	OAuth Client ID from Notion Integration settings
NOTION_CLIENT_SECRET	OAuth Client Secret from Notion Integration settings

Redirect URI

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

Important Notes

Note

Users must explicitly share pages and databases with the integration. The integration can only access content that has been shared with it.

• 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

Common Issues

Pages Must Be Shared

The integration can only access pages and databases that have been explicitly shared with it. Click the ”…” menu on a page, then “Add connections” and select your integration.

• “object_not_found” error: The page or database hasn’t been shared with the integration. Share it first.
• Nested block limits: The API only returns 2 levels of nested blocks. Deeply nested content may be truncated.
• Rich text formatting: Notion uses block-based formatting. Complex layouts may not translate perfectly to text responses.
• Database property types: Some property types (rollup, formula) are read-only and cannot be set via the API.

Testing

1. Go to your Switchboard Dashboard and navigate to Notion
2. Click Connect and authorize in your Notion workspace
3. Share at least one page or database with the integration
4. Click Test Connection to verify
5. Try: “Search my Notion pages for meeting notes”