Getting Started

Notion Integration Setup

Connect your Notion workspace to BrainTube: authorize access, choose pages and databases to sync, and learn how incremental sync keeps notes up to date.

Connect your Notion workspace to BrainTube to make your notes part of your knowledge corpus.

Connecting Notion

  1. Go to Knowledge Hub → Connected Sources
  2. Click "Connect Notion"
  3. Authorize BrainTube to access your Notion workspace
  4. Select which pages or databases to sync

What Gets Synced

  • Page titles and content
  • Database entries
  • Nested pages
  • Rich text formatting (converted to markdown)

Sync Behavior

  • Automatic sync — Changes in Notion propagate to BrainTube
  • Rate limited — 350ms between API calls to respect Notion's limits
  • Incremental — Only changed pages are re-synced
  • 2-second delay between users — Prevents hitting global rate limits

Callback Setup

After authorizing, you'll be redirected back to BrainTube via the Notion callback page. If this fails, check that popups aren't blocked, try the connection again from Knowledge Hub, and make sure you're logged into the correct BrainTube account.

Tips

  • Start by syncing a few key pages to test
  • Notion databases with many entries work best imported as a database
  • The integration preserves your Notion structure
Still need help? Email support.