SpeckyDocs

Notion Integration

What it does

Import pages, databases, and wikis from your Notion workspace.

How your data reaches Specky

Specky pulls from Notion on a schedule. A sync runs when you open your workspace if the data has gone stale, and you can trigger one by hand from the integration card at any time.

What you'll need

  • Internal Integration Token (Required) — Internal integration token from your Notion integration settings.

    • Setup

    Go to Settings → Integrations, find Notion, and click Connect.

    How to create an Internal Integration

  • Go to notion.so/profile/integrations
  • Click "+ New integration"
  • Give it a name like Specky
  • Select the workspace you want to connect
  • Under Capabilities, ensure Read content is checked
  • Click "Save" and copy the Internal Integration Token (starts with ntn_)

    • Share pages with the integration

    Important: Notion integrations can only access pages explicitly shared with them.

  • Open a Notion page or database you want to import
  • Click "•••" (three dots) in the top-right corner
  • Scroll down and click "Connect to" → select Specky
  • Repeat for any other pages/databases you want to sync

    • Data synced

    DataUsed for

    PagesProduct specs, meeting notes, wikis, decision logs Database entriesFeature trackers, roadmaps, OKRs Page content (text)Context for AI-powered PRD generation CommentsStakeholder feedback and decisions

    How Specky uses Notion data

  • Product Graph: Pages and database entries become graph nodes alongside Slack, Jira, etc.
  • PRD Generation: AI references your Notion docs when writing specs
  • Discovery Workbench: Surface related pages and decisions automatically

    • After connecting

    Everything Specky pulls in from Notion shows up in Discovery alongside your other sources, and feeds synthesis, clustering, and the AI chat's answers about your product. You don't have to do anything with it directly — it's there so the rest of Specky has something to reason over.

    Disconnecting Notion removes both the connection and the signals it brought in.

    Troubleshooting

  • Connected, but nothing appears. Open the Notion card and run a sync by hand. If it errors, the card shows the reason.
  • "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
  • Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.

    • See the Notion integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.