Overview

Export generated documents (PRDs, technical designs, business plans, etc.) and plan breakdowns to Notion as rich pages with full formatting support.

Prerequisites

• Notion workspace
• Ability to authorize integrations in your workspace
• Projan team admin or individual account

Setup Steps

1. Go to Settings > Integrations > Notion
2. Click “Connect Notion”
3. Select the pages and/or databases you want to grant Projan access to
4. Confirm the authorization

Permissions Requested

Notion uses page-based permissions rather than granular OAuth scopes. Access is limited to pages explicitly selected during authorization.

Permission	Purpose	Access Level
Read content	Read selected pages and databases	Read
Insert content	Create new pages	Write
Update content	Update existing pages	Write

What Data is Accessed

• Workspace name and icon
• Selected page titles
• Database schemas (for structured exports)

Data Storage

• Encrypted access token
• Workspace ID and name
• Bot ID

Notion tokens are long-lived and do not require a refresh flow.

Disconnecting

Go to Settings > Integrations > Notion > Disconnect.

This purges the stored token from Projan. You should also revoke access from Notion directly: Settings > Connections > Projan > Disconnect.

Troubleshooting

“Page not found”

• Re-authorize the integration and ensure the correct pages are selected
• Notion only grants access to explicitly chosen pages

Formatting issues

• Complex markdown (nested tables, code blocks with syntax highlighting) may be simplified during export
• Notion’s block API has formatting limitations compared to raw markdown

“Content too large” error

• Maximum 100,000 characters per export
• Split large documents into multiple pages if needed

Pages not appearing in selection

• Ensure you have edit access to the pages you want to grant
• Shared pages from other workspaces cannot be selected