Notion Integration Guide
Export AskVerdict debates and verdicts to Notion pages for team documentation and searchable decision archives.
Export completed debates to Notion to build a permanent, searchable record of your team's decisions. Each export creates a formatted Notion page containing the question, recommendation, confidence score, pros and cons, and a link back to the full debate.
Prerequisites
- An AskVerdict account (any plan)
- A Notion account with at least one workspace
- Notion workspace member or editor access (guest access is not sufficient for the OAuth flow)
Step 1: Connect Notion
- Go to Settings → Integrations in the AskVerdict web app
- Click Connect Notion
- You will be redirected to Notion's OAuth consent screen
- Select the pages and databases you want to give AskVerdict access to
Granting access
Notion requires you to explicitly select which pages or databases AskVerdict can access during the OAuth flow. You can grant access to a top-level page (e.g. "Decisions") and all child pages will be accessible. You can update access later from Notion Settings → Connections.
- Click Allow Access
- You will be redirected back to AskVerdict with a success confirmation
Step 2: Browse Your Notion Databases
After connecting, AskVerdict can list the databases and pages you shared access to:
GET /api/integrations/notion/databases
Authorization: Bearer vrd_your_api_key{
"databases": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"title": "Decision Log",
"type": "database",
"url": "https://notion.so/a1b2c3d4..."
},
{
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"title": "Engineering Decisions",
"type": "page",
"url": "https://notion.so/b2c3d4e5..."
}
]
}You can use either a database (creates a new database entry) or a page (creates a child page) as the export target. A database is recommended for structured filtering and sorting.
Step 3: Export a Debate
You can export any completed debate from the AskVerdict web app or the API.
Via the Web App
- Open a completed debate
- Click the Export button (top-right)
- Select Export to Notion
- Choose the target page or database from the dropdown
- Click Export
A link to the newly created Notion page will appear immediately.
Via the API
POST /api/integrations/notion/export/:debateId
Authorization: Bearer vrd_your_api_key
Content-Type: application/json
{
"targetPageId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"notionUrl": "https://notion.so/Should-we-adopt-Kubernetes-7f3a2b1c..."
}| Field | Required | Description |
|---|---|---|
targetPageId | Yes | The Notion page or database ID to export into |
The debateId in the URL path must belong to your account. Exporting another user's debate returns a 404 Not Found.
How Verdicts Appear in Notion
Each exported debate becomes a Notion page with the following structure:
Page title: [Question text]
Properties (if exporting to a database):
Status: Completed
Confidence: 74%
Mode: Balanced
Date: February 10, 2026
Source URL: https://askverdict.ai/debates/dbt_abc123
Body content:
Recommendation
─────────────
Migrate to AWS in a phased approach, beginning with stateless
services over 6 months.
Pros
────
• Eliminates hardware refresh cycles (~$180k every 3 years)
• Auto-scaling handles traffic spikes without operational overhead
• Managed services reduce on-call burden by ~30%
Cons
────
• 18-month payback period on migration investment
• Team upskilling required (estimated 6 weeks)
Full Debate → [Link to AskVerdict]Export to a Notion database (not a plain page) to unlock filtering by confidence score, mode, date, or any custom property you add. This works best for building a searchable decision archive.
Recommended Database Schema
If you create a dedicated Notion database for AskVerdict exports, set up these properties for best results:
| Property | Type | Maps to |
|---|---|---|
Name | Title | Debate question |
Confidence | Number (%) | Verdict confidence score |
Mode | Select | Debate mode (fast / balanced / thorough) |
Date | Date | Debate completion date |
Status | Select | Completed / In Progress |
Source URL | URL | Link back to AskVerdict debate |
Tags | Multi-select | Custom labels you add manually |
Integration Status
Check your current connection:
GET /api/integrations/notion
Authorization: Bearer vrd_your_api_key{
"connected": true,
"integration": {
"id": "int_ghi789",
"active": true,
"config": {
"workspaceName": "Acme Corp",
"workspaceId": "ws_abc123",
"databaseId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
},
"createdAt": "2026-02-01T10:00:00Z",
"updatedAt": "2026-02-10T14:30:00Z"
}
}Disconnecting
To remove the Notion integration:
- Go to Settings → Integrations
- Click Disconnect on the Notion card
- Confirm the disconnection
Or via the API:
DELETE /api/integrations/notion
Authorization: Bearer vrd_your_api_keyThis removes AskVerdict's Notion access token. To fully revoke access, also go to Notion Settings → Connections and remove AskVerdict from there. Your existing exported pages in Notion are not deleted. Your debate history in AskVerdict is not affected.
Troubleshooting
| Issue | Solution |
|---|---|
| "Notion integration is not connected" | Complete the OAuth flow at Settings → Integrations first |
| Database not appearing in the list | You did not grant AskVerdict access to it during the OAuth flow — go to Notion Settings → Connections → AskVerdict and add more pages |
| "Debate not found" | The debate ID may belong to another account, or the debate does not exist |
| Export creates a blank page | The debate may not be fully completed — only debates with a verdict can be exported |
| "Export failed" | The target page ID may be invalid, or the Notion API token may have expired — try reconnecting |
Notion's API does not support real-time sync. Each export is a one-time snapshot. If you update a debate's outcome in AskVerdict after exporting, you will need to re-export to update the Notion page.
Was this page helpful?