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:

• Supported Notion fields and other features

• Limitations and other considerations

• Necessary permissions
• Installation instructions before you integrate Notion with Unito

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.

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.

*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.

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:

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. 

3. Enable the Last edited time column in your databases. This is necessary in order for Unito to sync any data in Notion. 

   1. First, open any databases you want to add to a Unito flow.

   2. Add a new column using the Last edited time property type.

   3. You can hide this column but it must be on the database.

If you have any questions or feature requests, please reach out to us! We'll be happy to help.