> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitforms.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion Integration

> All-in-one workspace for notes & databases

<img src="https://mintcdn.com/orbitai-d647f397/T1yKN7sdBmMTM8cv/_images/integrations/notion.svg?fit=max&auto=format&n=T1yKN7sdBmMTM8cv&q=85&s=e367e3cd929ef818a4aabd43415f0675" alt="Notion" width="32" height="32" data-path="_images/integrations/notion.svg" />

[Visit Notion](https://www.notion.so)

## Overview

Connect your OrbitForms forms to Notion and automatically add submissions as pages in your databases. Perfect for tracking leads, managing requests, or building custom workflows in your team workspace. OrbitForms offers two ways to integrate with Notion: **Integration Page** for direct form-to-database connections and **Workflows** for advanced routing and filtering.

<CardGroup cols={2}>
  <Card title="Create Pages" icon="file-lines">
    Automatically create new pages in your Notion database from form submissions
  </Card>

  <Card title="Property Mapping" icon="database">
    Map form fields to any Notion property including selects, dates, and more
  </Card>

  <Card title="Rich Text Support" icon="layer-group">
    Long-form responses are added as rich text content in the page body
  </Card>

  <Card title="Workflow Integration" icon="code-branch">
    Use with AI qualification and enrichment before sending to Notion
  </Card>
</CardGroup>

## Choose Your Integration Method

Notion can be set up in two ways. Choose based on your needs:

<CardGroup cols={2}>
  <Card title="Integration Page" icon="gear">
    Use the Integration page when you want to send **all form submissions** directly to Notion without any filtering.

    * Simple 1:1 form-to-database mapping
    * No need for lead qualification first
    * Fastest setup for basic tracking

    [Set up Integration](#step-1-create-a-notion-integration)
  </Card>

  <Card title="Workflows" icon="code-branch">
    Use Workflows when you need **filtering, enrichment, or AI qualification** before sending to Notion.

    * Filter by lead score or qualification
    * Enrich leads before sending (Clay, etc.)
    * Use AI SDR qualification first
    * Route different leads to different databases

    [Learn more about Workflows](#using-notion-with-workflows)
  </Card>
</CardGroup>

## Step 1: Create a Notion Integration

First, you need to create an internal integration in your Notion workspace. This generates the API token that OrbitForms uses to connect.

<Steps>
  <Step title="Go to Notion Integrations">
    Open your browser and navigate to the Notion integrations page.

    Navigate to [notion.so/my-integrations](https://www.notion.so/my-integrations)
  </Step>

  <Step title="Create new integration">
    Click the "New integration" button to start creating your integration.
  </Step>

  <Step title="Name your integration">
    Enter a name like "OrbitForms Forms" and select the workspace you want to connect.
  </Step>

  <Step title="Set capabilities">
    Make sure "Read content", "Update content", and "Insert content" are enabled. These are required for OrbitForms to create pages.
  </Step>

  <Step title="Submit and copy token">
    Click "Submit" to create the integration. Then copy your Internal Integration Token — you'll need this in a later step.
  </Step>
</Steps>

<Info>
  For more details from Notion: [Create a Notion Integration Guide →](https://developers.notion.com/docs/create-a-notion-integration)
</Info>

## Step 2: Share Your Database with the Integration

Notion integrations can only access pages and databases that have been explicitly shared with them. You need to invite your integration to your target database.

<Steps>
  <Step title="Open your database in Notion">
    Navigate to the database where you want form submissions to appear.
  </Step>

  <Step title="Click the share button">
    Click the "..." menu in the top right corner of the database.
  </Step>

  <Step title="Add connections">
    Click "Add connections" or "Connect to" option.
  </Step>

  <Step title="Search for your integration">
    Type the name of your integration (e.g., "OrbitForms Forms") and select it.
  </Step>

  <Step title="Confirm access">
    Click "Confirm" to grant your integration access to this database.
  </Step>
</Steps>

<Warning>
  **Important:** You must share each database you want to use with OrbitForms. If you don't see your database in the dropdown later, it means the integration doesn't have access.
</Warning>

## Step 3: Connect Notion in OrbitForms

Now connect your Notion integration to OrbitForms using the token you copied earlier.

<Steps>
  <Step title="Go to Integrations in OrbitForms">
    From your dashboard, click "Integrations" in the left sidebar.
  </Step>

  <Step title="Find Notion">
    Scroll down or search for "Notion" in the integrations list.
  </Step>

  <Step title="Click to configure">
    Click on the Notion card to open the configuration panel.
  </Step>

  <Step title="Paste your integration token">
    Paste the Internal Integration Token you copied from Notion into the token field.
  </Step>

  <Step title="Click Connect">
    Click the "Connect Notion" button. You should see a success message and your shared databases will load.
  </Step>
</Steps>

## Step 4: Configure Form Field Mapping

Map your form fields to your Notion database properties. Each form field can be connected to a specific property in your database.

<Steps>
  <Step title="Select a form to configure">
    After connecting, you'll see a list of your forms. Click on the form you want to connect to Notion.
  </Step>

  <Step title="Select your database">
    Choose which Notion database should receive the form submissions from the dropdown.
  </Step>

  <Step title="Map the Title field (required)">
    Every Notion database needs a Title property. Map a form field (like Name or Email) to serve as the page title.
  </Step>

  <Step title="Map additional fields">
    Map other form fields to their corresponding database properties. Match field types where possible (email to Email, dates to Date, etc.).
  </Step>

  <Step title="Click Save">
    Click "Save" to save your mapping. New form submissions will now create pages in your Notion database.
  </Step>
</Steps>

### Supported Property Types

OrbitForms supports mapping to these Notion database property types:

| Property Type | Description                   | Best For               |
| ------------- | ----------------------------- | ---------------------- |
| Title         | Primary name field (required) | Name, Subject, Email   |
| Email         | Email addresses               | Contact email          |
| Phone         | Phone numbers                 | Phone number fields    |
| Text          | Short text content            | Company, Short answers |
| Rich Text     | Long-form content             | Messages, Notes        |
| Select        | Single choice from options    | Status, Type, Source   |
| Multi-select  | Multiple choices              | Tags, Interests        |
| Date          | Date values                   | Submitted at, Deadline |
| Checkbox      | Boolean true/false            | Subscribed, Agreed     |
| URL           | Website links                 | Website, Portfolio     |

## Using Notion with Workflows

For advanced use cases, add Notion as a destination in your workflows. This gives you more control over which submissions get sent to Notion.

Use workflows when you need to:

* Send only qualified leads to your Notion database
* Include enriched data from Clay, Clearbit, or other sources
* Route different form submissions to different Notion databases
* Combine with other destinations like CRMs in a single flow
* Use AI SDR to classify leads before adding to Notion

### Adding Notion to a Workflow

<Steps>
  <Step title="Create or open a workflow">
    Go to Workflows in your dashboard and create a new workflow or open an existing one.
  </Step>

  <Step title="Add a trigger">
    Set up a Form Submission trigger for the form(s) you want to connect.
  </Step>

  <Step title="Add any intermediate steps (optional)">
    Add AI Agent for qualification, Enrichment nodes, or Filter nodes as needed.
  </Step>

  <Step title="Add Notion destination">
    Click the + button and select Notion from the destinations list.
  </Step>

  <Step title="Configure the Notion node">
    Select your database and map your fields. You can use enriched data from previous nodes.
  </Step>

  <Step title="Save and activate">
    Save your workflow and toggle it to Active. Submissions will now flow through your workflow.
  </Step>
</Steps>

<Tip>
  **Example: Lead Tracking Database** — A common workflow that enriches and qualifies leads before adding to Notion:

  Form Submission → AI Agent (Qualify) → Clay (Enrich) → Notion
</Tip>

## Verifying Your Integration

After setting up your integration, verify that pages are being created in your Notion database:

<Steps>
  <Step title="Submit a test form">
    Fill out and submit your form with test data to trigger a page creation.
  </Step>

  <Step title="Open your Notion database">
    Go to the database you connected and look for the new page.
  </Step>

  <Step title="Verify the page data">
    Check that the page was created with the correct property values from your form submission.
  </Step>
</Steps>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Database not appearing in dropdown?">
    Make sure you've shared the database with your integration. Open the database in Notion, click the "..." menu, then "Add connections" and select your integration.
  </Accordion>

  <Accordion title="Integration token invalid?">
    Verify your integration is still active at notion.so/my-integrations. If you regenerated the token, update it in OrbitForms by disconnecting and reconnecting.
  </Accordion>

  <Accordion title="Pages not appearing in database?">
    Check that your form has a valid mapping saved. Also verify the Title field is mapped — Notion requires a Title property for every page.
  </Accordion>

  <Accordion title="Select values not matching?">
    For Select and Multi-select properties, the option must already exist in your Notion database or it will be created automatically. Make sure the values match exactly (case-sensitive).
  </Accordion>

  <Accordion title="Long text getting truncated?">
    For long-form content like messages or notes, use a Rich Text property type instead of Text. Rich Text supports longer content and formatting.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup cols={2}>
  <Card title="Manage Your Integrations" icon="link" href="https://www.notion.so/my-integrations">
    Notion integrations dashboard
  </Card>

  <Card title="Notion Integration Setup Guide" icon="book" href="https://developers.notion.com/docs/create-a-notion-integration">
    Official Notion guide
  </Card>

  <Card title="Notion Database API Reference" icon="code" href="https://developers.notion.com/reference/database">
    Developer documentation
  </Card>

  <Card title="Notion Website" icon="globe" href="https://www.notion.so">
    Visit Notion
  </Card>
</CardGroup>

***

**Ready to Connect Notion?** Set up Notion in minutes and start automatically adding form submissions to your databases. [Get Started](https://orbitforms.ai/signin)