Notion

Notion Connector Guide

This guide provides an overview of how to connect Whalesync to Notion and answers common questions.

Connecting to Notion

To connect Whalesync to Notion, you will need to authenticate using your Notion account. This process uses OAuth, which is a secure way to grant Whalesync access to your data without sharing your password.

When you authorize the connection, you will be taken to Notion's website. There, you can select which workspace and which specific pages or databases you want Whalesync to be able to access. Whalesync will only have permission to read and write to the pages and databases you explicitly select.

If you prefer not to sign in, or are connecting Notion through the API or MCP server, you can use an internal integration instead:

Connect with an internal integration

Syncing Data

Whalesync enables two-way synchronization for most Notion fields. This means that if you update a record in Notion, the change will be reflected in the connected application, and if you update a record in the other application, the change will be reflected in Notion.

Some fields in Notion, such as Created time or Last edited by, are inherently read-only. Whalesync can read data from these fields and sync it to other apps, but cannot write new data into them. For a detailed list of what is supported, please see the "Supported Fields" section below.

Automatic Table and Field Creation

Whalesync can automatically create tables and fields in Notion to match the structure of the other app you're syncing with.

Things to Keep in Mind

Relation fields

Whalesync supports relation fields out of the box! Note - Notion requires the "Two-way relation" option to be toggled in order for them to work.

Page Content Syncing

Whalesync can sync the full content of your Notion pages. However, there are limitations for pages with very high complexity (i.e. a large number of nested blocks). If you have issues syncing complex pages, please contact support.

Page content syncs both ways. If your sync connected Notion before October 2025, its Page Content field is read-only and reauthorizing Notion won't change that, so contact support to turn on two-way syncing for it.

Note that the Notion API is significantly slower than most other APIs. When syncing page content across large databases (thousands of pages), sync times can be much longer than usual because each page requires multiple API calls to fetch its full block content. For best performance, keep your synced Notion databases small and focused. See Notion page sync for more details.

Rollup Fields

Syncing data from Notion's rollup fields is not yet supported.

Auto-Creating Databases

If you use Whalesync's "Auto-create tables" feature to create a new database in Notion, you will need to have specified a parent page when authenticating with Notion. This tells Whalesync where to place the new database.

Synthetic Fields

Whalesync adds a few fields to your Notion data to help manage the sync. These fields are not present in Notion itself but are available in Whalesync.

Field Name	Description	Writable
Notion Record ID	The unique identifier for a page in Notion. This is used by Whalesync to track records.	No
Page Content	The full content of a Notion page, including text, images, and other blocks, represented as HTML.	Yes
Created At	The timestamp of when a record was first created by the sync.	No
Updated At	The timestamp of when a record was last updated by the sync.	No

Supported Fields

Field	Status
🤖 AI field	➡️ Supported (1-Way)
☑️ Checkbox	✅ Supported
🧑 Created by	➡️ Supported (1-Way)
🕠 Created time	➡️ Supported (1-Way)
📅 Date	✅ Supported
✉️ Email	✅ Supported
📂 Files & Media	✅ Supported
📊 Formula	➡️ Supported (1-Way)
🧑 Last edited by	➡️ Supported (1-Way)
🕠 Last edited time	➡️ Supported (1-Way)
🏷️ Multi-Select	✅ Supported
#️⃣ Number	✅ Supported
📝 Page content	✅ Supported
🫂 Person	➡️ Supported (1-Way)
📞 Phone	✅ Supported
🖇️ Relation	✅ Supported
🌀 Rollup	✖️ Not Yet
🔽 Select	✅ Supported
🟢 Status	✅ Supported
📝 Text	✅ Supported
🔗 URL	✅ Supported