Notion Sync

Creating a new integration in Notion

Create a new integration in your Notion integrations dashboard. For this example, we’ll call it Scout Integration, pick our associated workpace, and make it an internal integration.

Setting permissions of the integration

Once your integration is created, you will need to grant permissions.

We recommend granting the least priviledges; read content and no user information. The integration doesn’t need more than this.

Copy the integration’s API key

On the same page as the permissions settings, you will see Internal Integration Secret - copy that secret you will need it in the next steps.

Grant the integration permissions to desired pages and databases

Your Scout Notion integration will need permission to retrieve Notion content. By default, it won’t have access to anything. To provide access, do the following:

1. Go to each page or database in your workspace that you want to grant access to.
2. Click the ••• (more menu) on the top-right corner of the page.
3. Scroll to the bottom of the menu and click Add connections.
4. Search for and select your integration in the Search for connections… menu.
5. Once selected, your integration will have permission to read content from the page.

This will grant the Scout integration access to that page, and all child pages. This means, if you’re doing this for a database, all entries in that database will be made accessible to the integration.

Creating the Notion collection in Scout

Navigate back to Scout, and create a new collection. You can title it Notion Sync.

Add columns to the Notion collection

Click into your newly created collection. On the right hand side, click the plus sign to add the new columns to the collection.

You will need to add two columns:

1. Url - Set the column name to Url and the column type to URL.

2. Title - Set the column name to Title and the column type to Single Line Text.

Connect your Notion integration as a source

In the upper right hand corner of the collection, click the Sources button.

Select the Notion option. Enter the Secret from step 3, map the fields to the table columns we created, and optionally set a sync frequency.

The click Create +.

Run the source sync

Lastly, you will want to run the initial sync.

This will run a one time sync that pulls all of the notion pages and databases that you have grated the Scout integration access to. It’s best practice to inspect a few of the entries into the table to ensure everything looks good.