Notion Integration

This guide explains how to connect Notion to Supervity, what data is available after connection, how operators can use Notion data and actions within workflows, and how to remove the integration when needed.

---

Overview

The Supervity Notion integration allows your workspace to securely connect Notion as a governed platform capability.

Once connected, operators and workflows can use Notion data and actions to automate business processes, retrieve and organize documentation, manage database records, and coordinate work across systems.

With the Notion integration, Supervity can:

• Access pages, databases, and blocks shared with the integration
• Retrieve page properties and structural content
• Query, filter, and sort database items
• Create and update pages inside shared parent pages or databases
• Append, modify, or remove block elements (such as text paragraphs) within documents
• Archive or restore pages
• Use document and database content as context for operators
• Coordinate cross-system updates between Notion and other business platforms

All Notion access is governed through Supervity's security, permissions, and audit controls.

---

Prerequisites

Before connecting Notion, ensure you have:

• An active Supervity workspace
• A Notion account (Personal or Workspace)
• Permissions to authorize integrations or add connections in your Notion workspace
• An understanding of Explicit Page Sharing: Notion does not expose the entire workspace by default. The integration can only see and interact with pages and databases that you explicitly share with it (selected during the initial authorization screen or added later via the "Connections" menu on specific pages).

---

Adding the Notion Integration

Follow these steps to connect Notion to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.

Step 1: Open Integrations

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.

This opens the Integrations page, where all available integrations are managed.

Step 2: Select Notion

1. Locate Notion in the available integrations list.
2. Click Connect.

Step 3: Authorize Access

You will be redirected to Notion's secure authorization page.

1. Review the access request.
2. Click Select pages to choose which top-level pages and sub-pages the integration is allowed to access.
3. Grant access to the selected pages to complete the flow.

• Supervity uses Notion's standard OAuth 2.0 authorization flow.
• Your Notion credentials and password are never shared with or stored by Supervity.
• Granting access to a parent page automatically includes access to its child pages and sub-databases.

Step 4: Complete Connection

After authorization, you will be redirected back to Supervity.

The Notion integration will appear as Connected on the Integrations page. Your workspace can now securely access Notion capabilities according to the page selections made during authorization.

Having trouble? See the Troubleshooting section for step-by-step help with common setup issues.

---

How Notion Works in Supervity

After connection, Notion becomes available as a governed platform tool.

Operators use Notion when planning and executing documentation and tracking tasks, while workflows automate structural updates based on business events.

Common use cases include:

• Creating documentation pages from templates
• Querying tracking databases to compile status reports
• Appending updates, summaries, and action items directly to existing meeting pages
• Syncing task statuses between Notion databases and external project management tools
• Archiving outdated document branches automatically

---

Using Notion in Operators

Connected Notion capabilities become available to operators automatically. Operators determine when document updates or database queries are required to complete a task and execute accordingly, governed by workspace permissions, security controls, and approval policies.

What Operators Can Do with Notion

Operators can perform the following actions using Notion:

• Search and list shared pages and databases
• Retrieve the properties, metadata, and structural layout of a page
• Create new pages under shared documents or database containers
• Update page titles, select fields, dates, and other properties
• Archive pages when they are no longer needed
• Query databases using filters and sorts to retrieve specific entries
• Create new databases inside authorized parent pages
• List, retrieve, append, update, or delete individual content blocks (such as text, headings, or lists) within a page

Typical Operator Use Cases

---

Features & Prerequisites

For each Notion capability available in Supervity, the following describes the use case and the prerequisites required before use.

Page Operations

Use Case: Retrieve, create, update, or archive individual pages. Useful for managing document structures, updating status properties, and organizing operational workspace files.

Prerequisites:

• Notion account connected to Supervity
• The target page (or its parent page/database) must be explicitly shared with the integration

---

Database Queries and Listing

Use Case: List available databases and query database rows with filtering and sorting configurations. Useful for extracting structured task lists, client directories, or project schedules.

Prerequisites:

• Notion account connected to Supervity
• The target database must be shared with the integration
• Query properties (e.g., status, dates) must match the database's schema configuration

---

Database Management

Use Case: Create new databases or update existing database titles. Useful for setting up fresh tracking modules or structuring new project outlines programmatically.

Prerequisites:

• Notion account connected to Supervity
• The parent page where the database will reside must be shared with the integration
• The integration must have content insertion capabilities enabled

---

Block Operations

Use Case: List, retrieve, append, update, or delete structural block elements (such as paragraphs or headers) within a page. Useful for detailed document generation and inline editing.

Prerequisites:

• Notion account connected to Supervity
• The containing page or parent block must be shared with the integration
• Appending child blocks supports nesting structures up to two levels in a single call

---

Permissions Requested

Supervity requests permissions to perform actions on the resources you choose to share.

Because Notion controls access on a per-page level during connection, the permissions apply strictly to your shared selection:

Supervity follows least-privilege principles and only interacts with data explicitly exposed to the integration.

---

Authentication & Security

The Notion integration uses OAuth 2.0 authentication.

Security controls include:

• Encrypted token storage (AES-256)
• Page-level access selection controlled by the user during authorization
• Internal token rotation support
• Immediate access revocation capabilities
• Workspace-level governance controls
• Complete audit logging
• TLS 1.3 for all secure connections

All Notion interactions remain subject to Supervity security policies and role-based permissions.

---

Managing the Integration

View Connection Status

From the left navigation bar, click the Integrations icon.

For Notion you can view:

• Connection status
• Associated workflows and operators
• Last usage timestamps

Reconnect Notion

If you need to share additional pages, or if the connection expires:

1. Open the Integrations page from the left navigation bar.
2. Select Notion.
3. Click Reconnect.
4. Use the page selector to add or update authorized pages.
5. Complete authorization again.

Existing workflows do not need to be modified after reconnection.

Removing the Notion Integration

You can disconnect the Notion integration from your Supervity workspace at any time.

Steps to Remove

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.
3. Locate and select Notion from the integrations list.
4. Click Disconnect.
5. Confirm the action when prompted.

Implications of Removal

Once removed:

• Supervity loses access to your Notion account and shared content
• Workflows depending on Notion actions will stop executing and fail safely
• Stored tokens are permanently cleared
• Historical execution logs are preserved for auditing purposes

How Your Data Is Handled After Removal

Data Handling on Disconnection:

• Supervity loses API access immediately upon disconnection
• Access tokens and associated account metadata are deleted from Supervity's systems within 15 minutes of removal
• Temporary workflow data is cleared following execution completion

---

Auditing & Observability

All Notion activity executed through Supervity is logged.

Audit records track:

• The operator or workflow triggering the action
• Execution timestamps
• Success or failure statuses
• Affected page or database identifiers (redacted when sensitive)

---

Troubleshooting

If you encounter issues at any stage, refer to the steps below. For issues not covered here, contact the Supervity support team.

Authorization Failed During Setup

Likely Cause: Logging into the incorrect Notion workspace during the authorization flow, or workspace-level settings that restrict members from adding third-party integrations.

Resolution:

1. Ensure you are signed in to the correct Notion account and workspace in your browser before starting.
2. During the authorization flow, verify the active workspace shown in the dropdown selector in the top-right corner of the Notion authorization screen.
3. Confirm with your Notion workspace administrator that integrations are allowed (Workspace owners may need to approve the integration under Settings & Members → Integrations).
4. Return to Supervity → Integrations → Notion and click Connect to retry.

---

Page or Database Not Found (404 / Object Invisible)

Likely Cause: The target page or database has not been shared with the integration.

Resolution:

1. Open the target page in the Notion app.
2. Click the ••• menu in the top-right corner.
3. Under Connections, click Add connections and search for your Supervity integration to grant access.
4. Alternatively, go to Supervity → Integrations → Notion, click Reconnect, and verify the page or its parent is checked in the Notion authorization screen.

---

Action Denied (403 Forbidden)

Likely Cause: The integration has insufficient permissions (e.g., trying to write to a read-only parent location) or the workspace setup restricts integration capabilities.

Resolution:

1. Confirm that the parent page or database allows write access.
2. Verify that the user who authorized the integration has permission to modify the target location.
3. Ensure your Notion workspace settings permit integrations to insert and edit content.

---

Database Property Schema Mismatch

Likely Cause: The properties sent during a page creation or update request do not match the database's configured column names or types.

Resolution:

1. Review the schema of the target database in Notion.
2. Verify that the property names, text formats, and select options in your workflow parameters match the database columns exactly.
3. Check that the title property matches the designated Title column name.

---

Connection Expired or Invalid Grant

Likely Cause: Stored access credentials have been revoked or changed within Notion settings.

Resolution:

1. Navigate to Integrations → Notion → Reconnect.
2. Complete the authorization flow again.

---

Frequently Asked Questions

Q: Is my Notion password shared with or stored by Supervity?

No. Supervity uses secure OAuth 2.0 authorization. Your password is never shared with or stored by Supervity. Only authorized access tokens are stored, encrypted at rest using AES-256.

---

Q: Why is a child page not showing up in search results?

A child page is accessible only if its parent page is shared with the integration. If you share a parent page, all nested child pages and databases automatically inherit access. If the parent page access was restricted or not checked during connection, the children remain invisible.

---

Q: Can I add a connection directly from Notion without reconnecting in Supervity?

Yes. Once the integration is connected, you can share new pages with it directly from within the Notion interface. Use the ••• menu on any page, select Add connections, and find your Supervity integration.

---

Q: What happens if I update a database schema in Notion?

If you modify the schema (e.g., rename columns or change property types) in Notion, you will need to update the corresponding properties in your workflow parameters to match the new configuration.

---

Q: Who do I contact if I have an issue with the integration?

Contact the Supervity support team. See the Support section below for full details.

---

Support

If you need assistance with the Notion integration, visit the Support page.

Support Hours

• Monday to Friday, 9:00 AM – 6:00 PM IST
• Requests submitted outside business hours will be addressed on the next business day

First Response SLA

• All support requests receive an initial response within 24 business hours

Contact Information

When Contacting Support, Please Provide

• Workspace name
• Notion account email used for authorization
• Relevant workflow or operator information
• Error messages or screenshots when available

---

Related Documentation

• Integrations Overview
• OAuth2
• Security & Privacy
• Supervity Website