Start with one real question and leave with a next step.
Start with the question in front of you, then use the guide to make the next decision easier.
Try saying
“I am trying to make this decision. What should I look at first?”
Start with context
Bring the smallest useful example.
Look for the signal
Separate what is known from what is assumed.
Take one step
Choose an action you can review.
Notion Integration
What this connection is for
Bring selected Notion pages and databases into Specky, then send finished PRDs back when you are ready.
How your data reaches Specky
Specky pulls from Notion on a schedule. A sync runs when you open your workspace if the data is stale, and you can also start one by hand from the integration card.
Before you start
- Internal Integration Token (Required) — Internal integration token from your Notion integration settings.
Setup
Open Settings → Integrations, find Notion, and click Connect. The form will tell you what to paste and where to find it.
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
| Data | Used for |
|---|---|
| Pages | Product specs, meeting notes, wikis, decision logs |
| Database entries | Feature trackers, roadmaps, OKRs |
| Page content (text) | Context for PRD generation |
| Comments | Stakeholder 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
New Notion items appear in Discovery alongside your other sources. You can search them, ask questions about them, and cite them in product work without opening another tab.
Disconnecting Notion removes 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.
Ready to apply this?
Start with your own product and keep the first read grounded. You'll create an account before the guided result so it can be saved to your workspace.