Notion Integration

DejaSync enables seamless two-way synchronization with Notion, allowing you to keep your databases in sync with Google Sheets, Airtable, Monday.com, and other platforms.

Getting Started

Connecting Notion

1. During sync creation, select Notion as one of your apps
2. Click Connect to authorize DejaSync
3. You'll be redirected to Notion's OAuth page
4. Sign in to your Notion account
5. Select which pages and databases to share with DejaSync
6. You'll be redirected back to complete your sync setup

Selecting Your Data

After connecting, you'll be able to:

• Choose a workspace: Select from all workspaces you have access to
• Select databases: Pick specific databases to sync
• Map properties: DejaSync automatically detects and maps matching properties

Supported Property Types

DejaSync supports a wide range of Notion property types. The table below shows all supported properties and their sync capabilities.

Property Type Notes

Read-Only Properties: Person, Formula, Rollup, Created time, Created by, Last edited time, Last edited by, and ID properties are system-managed and cannot be written to.

Title Property: Every Notion database must have exactly one Title property. This is the primary identifier for each page.

Rich Text: Text properties support rich formatting, but only plain text is synced to maintain compatibility with other platforms.

Formula & Rollup: These properties are calculated based on other data. They can be synced to other apps as their computed values, but the formulas themselves are not transferred.

Relations: When syncing relations, DejaSync syncs the page IDs. The actual related page content is not expanded.

Files & Media: File attachments are synced as URLs. The files themselves remain hosted by Notion.

Person Properties: User assignments are synced by email address. Users must exist in both platforms.

Best Practices

Database Structure

• Clear property names: Use descriptive, unique names that match across platforms
• Title property: Ensure your database has a meaningful title property
• Consistent types: Keep property types consistent for reliable syncing

Field Mapping

• Match property types: Ensure compatible property types for smooth syncing
• Title mapping: Map the Notion title property to primary text fields in other apps
• Status vs Select: Status and Select properties are similar but Status has additional workflow features

Sync Direction

• Bidirectional sync: Best for collaborative editing across platforms
• One-way to Notion: Use when Notion is your primary knowledge base
• One-way from Notion: Use when Notion is your data source

Performance Tips

• Limit properties: Only sync the properties you actually need
• Filter databases: Use database views to focus on relevant pages
• Avoid large text: Very large text properties may slow down syncs

Common Use Cases

Notion ↔ Google Sheets

Combine Notion's flexible databases with spreadsheet analysis.

Example: Sync a Notion project database to Google Sheets for custom charts and pivot tables.

Notion ↔ Airtable

Integrate Notion's workspace with Airtable's relational database features.

Example: Keep Notion content calendar in sync with Airtable for advanced content planning and analytics.

Notion ↔ Monday

Merge Notion's documentation with Monday's project management.

Example: Sync Notion task database to Monday boards for team-wide project tracking.

Troubleshooting

Connection Issues

Problem: "Failed to connect to Notion"

• Solution: Ensure you've selected the specific pages/databases to share with DejaSync
• Verify you have edit access to the databases you want to sync
• Try disconnecting and reconnecting your Notion account

Sync Errors

Problem: "Property type mismatch"

• Solution: Verify that mapped properties have compatible types
• Check the property type table above for compatibility

Problem: "Title property required"

• Solution: Every Notion database must have a Title property
• Ensure the Title property is mapped to a text field in the other app

Problem: "User not found"

• Solution: For Person properties, ensure users exist in both platforms
• Users must have matching email addresses

Problem: "Permission denied"

• Solution: Ensure you've shared the database with DejaSync during connection
• Re-authorize DejaSync if database permissions have changed

Data Not Syncing

Problem: Changes not appearing in Notion

• Solution: Check your sync interval and manually trigger a sync
• Verify that property mappings are correct
• Ensure the database is still shared with DejaSync
• Review Activity logs for detailed error messages

Problem: Rich text formatting lost

• Solution: Only plain text is synced to maintain compatibility
• Formatting must be reapplied manually in Notion if needed

Problem: Formula properties not updating

• Solution: Formula properties are read-only and calculated by Notion
• Sync the source properties instead to update formula values

Problem: Relations not syncing

• Solution: Ensure both related databases are accessible
• Relations sync as page IDs, not full page content

API Rate Limits

Notion has API rate limits that DejaSync respects:

• 3 requests per second per integration
• DejaSync automatically throttles requests to stay within limits
• Large databases may take longer to sync due to rate limiting

Permissions

DejaSync requires the following Notion permissions:

• Read content: To access your database data
• Update content: To modify database pages and properties
• Insert content: To create new pages during sync

You control which specific pages and databases DejaSync can access during the connection process.

Page Content Syncing

Important: DejaSync syncs database properties, not page content (blocks). The rich text content within Notion pages is not synced, only the structured database properties.

If you need to sync page content, consider:

• Using a Text property to store the content
• Exporting page content to a text field before syncing

Learn More

• Notion Database Properties Documentation
• Notion API Documentation
• DejaSync Quick Start Guide

---

Need help? Check out our Quick Start Guide or contact support for assistance with your Notion integration.