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
• How to find Notion databases to sync

Unito's Notion connector syncs pages within a database, where each page is represented as a row in the Notion UI. Depending on your needs, a page can be displayed from the UI in a table, a list, a dashboard, etc.

Notion pages in this format are then synced to 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.

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:

• Connect Notion and/or another tool

• Choose a flow direction

• Set up rules to filter items from syncing

• Link fields between tools

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

• Attachments: Unito's Notion integration doesn't yet support attachment syncing.

• Supported pages: Unito's Notion integration only syncs with Notion databases, not tables. To sync a table, convert it to a database, name it, and then you can sync it in a flow.

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

• Webhooks: This integration doesn't support webhooks.

• Character limits: Notion's API limits text blocks to 2000 characters. If you sync longer text fields, the excess will be cut off, potentially leading to data loss in two-way syncs. To avoid this, don't sync fields over 2000 characters to Notion. This is a limitation on the Notion side, and unfortunately not something we can control.

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. 

How to find a new Notion database to sync

Here's a quick demo showing you how to add your databases to Unito:

Related articles

• What is flow direction?
• Add rules to your Unito flow
  • Sync by status fields
  • Sync labels or tags
• How to link and map fields in Unito
• How do I monitor flow activity?