An Overview of Unito’s Notion Integration

Looking to add Notion to your workflow? Here's what you can expect from Unito's integration.

What this article covers:

Unito can sync data from Notion pages with work items (e.g., tasks, tickets, events, etc.) in other tools with automated 2-way updates on either end. By creating a Unito flow, you'll be able to keep Notion and your other tool(s) refreshed in real-time whenever changes are made from end-to-end.

This article will give you an overview of supported functionality in Notion, as well as the limitations of Unito's integration.

How do you sync Notion pages with Unito?

To connect Notion and/or another tool through Unito Sync Platform, users create flows. Flows represent the connection between Notion and other tools comprised of four steps:

IMPORTANT: Only one Notion user per workspace can connect to Unito — this is a limitation from Notion’s API. We recommend setting up a shared account for your team's Notion flows.

If multiple Notion users attempt to login to your organization's Unito account to create flows, it may cause previously created flows to stop functioning.

Supported Notion fields and other features

The table below lists out all the fields you can sync with Unito's Notion integration, as well as which ones can be used to filter work items from syncing through rules.

Quick definitions:

    • One-Way: Changes to the Notion field will appear in the other synced field but not vice versa.
    • Two-Way: Changes to either synced field will appear in the other.
    • Rules: This Notion field can be used as a trigger in your rules to filter work items from syncing with Unito.
Notion Page Fields One-way Two-way Rules
Title  
Author    
Checkbox  
Created date    
Date*
Dropdown (multi-select)
Dropdown (single-select)
Editor    
Email  
Last edited time    
Link to page    
Number*  
Person*
Phone number  
Relation**    
Rich text
Row id    
Url  

*When filtering by Date, Number, or People, Unito can only filter by “any value” or “no value”.

**Relation fields are used to sync subtasks in Notion. You won't be able to map these fields if they link to work items outside the Notion database they're in.

Watch a demo video sync Notion pages between databases

What counts as an item in sync?

For Notion, Unito counts every synced page as an item in sync.

Limitations and other considerations for Unito's Notion integration

  • Sync attachments: You won’t be able to sync attachments to (and from) Notion just yet.

  • Supported pages: Currently, our Notion integration can only sync information that comes out of a Notion database. Notion tables can't be used as blocks of work for this integration. If you turn a Notion table into a database, just make sure you give that database a name and it will show up in your flow as a block of work.

  • Rich text: That means no formatted text, no mentions, and no emojis 😞

  • Webhooks: This integration doesn't support webhooks.

  • Status: You won't be able to sync this field with Unito's Notion integration.
  • Character limits: Notion's API limits each block to 2000 characters. That means if you sync a work item from another tool that has a field with over 2000 characters, the data in that field will be shortened to 2000 characters. This is a limitation on the Notion side, and unfortunately not something we can control. Note that if your flow is built with two-way updates enabled, the field in the original tool can have its length reduced to 2000 characters to stay synced with Notion, which can result in lost data. The best way to avoid this is to make sure you don't sync a single field with more than 2000 characters to Notion.

Necessary permissions for connecting Notion to Unito

For Unito to sync data through your Notion account, it is essential that you possess the required permissions. These permissions determine the extent of actions Unito can carry out, from reading and writing data to creating new sheets and managing webhooks, ensuring a secure and efficient data sync process.

Rest assured, Unito is SOC 2 Type 2 certified, and all your data is fully encrypted while in transit.

OAuth Scopes

During the authorization process, you'll need to select the pages or databases you want to give Unito access to — along with its children.

Read & Write Pages (view and edit) View and edit pages you select in the next step. You can also share pages later with Unito via the Share menu.
Read & Write Pages (create new) Add new pages or databases inside pages you have access to.
Read Email address View all workspace members and guests, as well as their email addresses.

Installation instructions before you integrate Notion with Unito

To be able to use Unito’s two-way Notion sync, there are a few considerations to keep in mind.

You need edit permissions in any databases you plan on syncing

In order to sync pages from a Notion database, you must have permission to edit that database. Here's an example of how databases can be found in Unito:

Notion Databases 1

Make sure only one Notion user per team has access to Unito

As mentioned above, due to limitations in Notion's API, only one Notion user from your team can create Unito flows.

If anyone else from your team tries to login with a separate account to create a flow, it may cause previously-created flows to stop functioning.

To keep your flows running smoothly, you can either ensure that only one person from your team will create Notion flows in Unito, or you can create a bot account as described below:

You can think of a bot account as a shared account that anyone on your team can use explicitly to create Notion flows in Unito. Here's how to set it up:

  1. Create a new Notion account with access to all pages and databases in your workspace. Give it a name that everyone will recognize as a shared account. Only share this account with users who absolutely need it.

    1. In the share menu in the top-right, search for the name of your shared account, or bot, and invite it to each page.
    2. Make sure this account has the "Can edit" permission.
  2. Login to Unito and connect your shared, or bot, Notion account. 

    1. You don't need to reauthorize your shared account when you want to sync more databases. You just need to invite that account to your other databases in Notion as you would any other user. 

Got feedback? Submit a Unito feature request to let us know what you'd like to see in the next update to our Notion integration.