Notion Integration

Vesper Audit can send audit results directly to a Notion workspace. When configured, each completed audit creates or updates a structured set of Notion pages with the full violations report, summary, and best practices findings - no copying and pasting required.

What gets sent to Notion

After a successful scan, Vesper Audit creates the following page structure under your configured Notion parent page:

Your Notion Parent Page
  Audit: example.com - August 15, 2025
    Summary
    WCAG Violations
    Best Practices
    Broken Links

Each section maps to the equivalent output file. The parent page serves as your audit log, accumulating a record of every audit run.

Prerequisites

• A Notion account (free or paid)
• A Notion integration token with write access to the target workspace
• The page ID of the Notion page where audit results should be written

Step 1 - Create a Notion integration

1. Go to notion.so/my-integrations (opens in a new tab).
2. Click New integration.
3. Give it a name (e.g., "Vesper Audit") and select the workspace it should have access to.
4. Set capabilities to Read content and Insert content (write access is required; update access is optional but recommended).
5. Click Save and copy the Internal Integration Token that is generated.

Step 2 - Share your Notion page with the integration

1. In Notion, open the page where you want audit results to be written.
2. Click ... (three dots menu) in the top right corner.
3. Click Connections, then find and add your integration.

The integration must be connected to the page (or a parent of the page) to be able to write to it.

Step 3 - Find your Notion page ID

The page ID is the 32-character string at the end of the page's URL:

https://www.notion.so/My-Audit-Log-334e719e6cd18170b562cdbf4de042af
                                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                    This is the page ID

The 32-character ID is the string at the very end of the URL, after the last hyphen: 334e719e6cd18170b562cdbf4de042af

Step 4 - Configure Vesper Audit

1. Open Vesper Audit and go to Settings > Notion Integration.
2. Paste your integration token into the API Token field.
3. Paste your page ID into the Parent Page ID field.
4. Click Test Connection to verify the integration can reach Notion.

Once configured, every completed audit will automatically push results to Notion. You can disable this at any time by toggling Send results to Notion off in Settings.

How sync works

When Notion export is enabled, the app fires audit-complete as soon as the scan finishes - your results appear immediately in the in-app viewer and any other enabled export formats. Notion sync then continues in the background.

• A sync strip appears in the Audit panel showing the domain and page count as it progresses.
• You can start a new audit while a sync is running - each sync runs independently and shows its own strip.
• If you try to quit while a sync is active, Vesper Audit will ask you to confirm. Quitting mid-sync leaves the Notion audit page partially populated - the parent page and some child pages will exist but may be incomplete.

Per-client Notion pages

For multi-client workflows, configure a separate parent page ID for each client. Include the page ID in each client's exported settings file (see Settings Import & Export) so that importing a client's settings automatically points results to the correct Notion page.

Troubleshooting

• "Could not connect to Notion" - check that your token is correct and that the integration has been added to the target page via Connections.
• "Page not found" - check that the page ID is correct and that the integration has access to that page.
• Results appear on the wrong page - confirm the page ID in Settings matches the intended Notion page.