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.
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.
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 read-only fields to your Notion data to help manage the sync. These fields are not present in Notion itself but are available in Whalesync.
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.
No
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
🤖 AI field
☑️ Checkbox
🧑 Created by
🕠 Created time
📅 Date
✉️ Email
📂 Files & Media
📊 Formula
🧑 Last edited by
🕠 Last edited time
🏷️ Multi-Select
#️⃣ Number
📝 Page content
🫂 Person
📞 Phone
🖇️ Relation
🌀 Rollup
🔽 Select
🟢 Status
📝 Text
🔗 URL
Last updated
Was this helpful?