How can we help you?

1. Overview & System Requirements

The Gravity Forms Notion Integration Add-on allows you to automatically synchronize form submissions directly into your Notion databases in real time. Whether you manage customer lead pipelines, product feedback boards, job applications, or project tasks in Notion, this add-on creates structured database pages instantly without requiring third-party webhook middleware or monthly automation fees.

2. Authentication & API Connection

1. Go to the Notion Developers Integrations Portal.
2. Click + New integration, name your integration (e.g. Gravity Forms Integration), select your associated workspace, and click Submit.
3. Copy your generated Internal Integration Secret Token (starts with secret_...).
4. Open the Notion Database you want to sync in your browser or desktop app, click the ••• menu in the top right corner, scroll down to Connections, and select your newly created integration to grant access.
5. In WordPress, navigate to Forms → Settings → Notion, paste your Secret Token, and click Save Settings.

3. Feed Configuration & Field Mapping

Navigate to your form settings and click the Notion Integration tab to configure your integration feed:

• Database Discovery: Select your connected Notion Database from the dropdown list. The add-on dynamically discovers all database properties.
• Title Property Mapping: Map primary text fields (e.g., Client Name or Inquiry Subject) to your Notion Database Title column.
• Rich Property Support: Map form fields to Text, Number, Select, Multi-Select, Date, Email, Phone Number, URL, and Checkbox properties.
• Dynamic Tags: Automatically assign predefined status badges or tags to newly generated database rows.

Detailed Notion Property Type Mapping Matrix

The Notion Database API enforces strict data formatting schemas for every column type. The add-on automatically handles data type normalization, JSON serialization, and sanitization before dispatching payloads to Notion:

4. Advanced Workflows & Conditional Logic

Advanced database routing workflows:

• Multi-Database Branching: Create multiple feeds with conditional logic to route bug reports to an Engineering Database and sales inquiries to a CRM Database.
• Lead Priority Classification: Conditionally assign “High Priority” select tags when inquiry budgets exceed specific thresholds.
• Entry Metadata Injection: Push entry submission date, IP address, and user browser details directly into Notion table columns.

Diagnostic Error Code & Resolution Matrix

When synchronizing form entries with Notion, the official Notion REST API returns standard HTTP status responses. Consult this reference matrix to quickly resolve operational issues:

Frequently Asked Questions (FAQ)

5. Troubleshooting & Common Error Codes

6. Developer Extensibility & Filter Hooks

Customize Notion page properties before creating the database row:

add_filter('ge_notion_page_properties', function($properties, $feed, $entry, $form) {
    // Dynamically inject custom metadata property
    $properties['Source Channel'] = [
        'select' => ['name' => 'Gravity Forms Website']
    ];
    return $properties;
}, 10, 4);