Productivity

Notion

15min

﻿
Notion is a productivity and note-taking web application. With the Notion app in ﻿, you can manage the database items, pages, and page content in your Notion account.
Requirements
To use the Notion app in ﻿ you must have a Notion account. Your Notion account must have admin permissions to establish the connection in ﻿.
Connect Notion and ﻿ 
﻿﻿ provides two ways to connect to the Notion app:
﻿Internal connection﻿﻿
﻿Public connection﻿﻿
Create the internal connection
To craete a Notion internal connection, you first need to:
1
﻿Obtain the internal integration token in yoru Notion account﻿.
2
﻿Create the internal connection in Make﻿.
Obtain the internal integration token in Notion
Before you create the internal connection in ﻿, you should first obtain an internal integration token in your Notion account.
To obtain the internal integration token: 
1
Log in to your Notion account.
2
Click Settings & Members > Connections > Develop or manage integrations from the sidebar or go to the My integrations page.
3
Click New Integration.
4
Select the Associate workspace, fill in the integration Name, upload a logo (optional), choose the Associated workspace, and click Submit.
5
Go to Capabilities, update the requested capabilities, and click Save changes.
6
Go to Secrets, click Show next to your internal integration token, and copy the token. Store your token in a safe place.
You'll use this value in the Internal Integration Token connection field in ﻿.
Create the internal connection in ﻿ 
Once you have your Notion internal integration token, you're ready to create the connection in ﻿. 
To create the connection:
1
Log in to your ﻿ account, add a Notion module to your ﻿, and click Create a connection.
2
In the Connection type dropdown, select Notion Internal.
3
Optional: In the Connection name field, enter a name for the connection.
4
In the Internal Integration Token field, enter the internal integration token you copied from your Notion account. 
5
Click Save.
You've successfully created the connection and can now use the Notion app in your ﻿. If you want to make changes to your connection in the future, follow the steps here﻿.
Create the public connection
To create the public connection:
1
Log in to your ﻿ account, add a Notion module to your ﻿, and click Create a connection.
2
In the Connection type dropdown, select Notion Public.
3
Optional: In the Connection name field, enter a name for the connection.
4
Optional: Click Show Advanced Settings and enter your client credentials. See Obtain Notion Client Credentials﻿.
5
Click Save.
6
If prompted, authenticate your account, click Select pages, select the pages you want Make to have access to, and click Allow access.
You've successfully created the connection and can now use the Notion app in your ﻿. If you want to make changes to your connection in the future, follow the steps here﻿.
To obtain your Notion client credentials:
1
Log in to your Notion account.
2
Click Settings & Members > Connections > Develop or manage integrations from the sidebar or go to the My integrations page.
3
Click New Integration.
4
Select the Associate workspace, fill in the integration Name, upload a logo (optional), choose the Associated workspace, and click Submit.
5
Go to Capabilities, update the requested capabilities, and click Save changes.
6
Go to Distribution and click the toggle to make the integration public.
7
Fill in your organization information and click Submit.
Field
Value
Redirect URIs
Enter the redirect URI:
https://www.integromat.com/oauth/cb/notion2
Company Name
Name of your company or organization. You may use your own name if this does not apply.
Website or homepage
Used to link to your integration’s website or homepage in your integration page and authentication screens.
Tagline
Optional: A short description of the integration.
Privacy policy
URL address used to link to your integration’s privacy policy in your integration page and authentication screens.
Terms of use
URL address used to link to your integration’s terms of use in your integration page and authentication screens
Support email
Used to link to your integration’s support email in your integration page and authentication screens.
Notion URL for optional template
Optional. URL must be for a public Notion page. Use this field if you'd like to duplicate a template into a user's workspace during OAuth.
﻿
8
Click Continue in the Switch to Public integration? prompt.
9
Copy the OAuth client ID and OAuth client secret and save them in a safe place. You will not be able to view the OAuth client secret more than once.
You have successfully created your client credentials.
Add Databases to be visible in ﻿ 
For the Notion internal connection, by default, Notion databases do not appear in the Database ID field > Search option. You must manually add them to the Notion app in ﻿ from your Notion account.
﻿
To add databases from your Notion account to the Notion app in ﻿:
1
Log in to your Notion account.
2
Enter into the database you want to add to Make , click on ... in the top right corner, click Add connections, search for and click on the integration you previously created, and click Confirm.
The database is successfully shared and you can now see it in a module's Database ID > Search field.
﻿
Retrieve added databases and pages after establishing the connection
If new databases or pages are added to the Notion account, you must revoke the connection in your Notion account and reauthorize the connection in ﻿ to retrieve the added databases or pages.
To retrieve the newly added databases and pages:
1
Log in to your Notion account.
2
Click Settings & members > Connections > ... > Disconnect all users.
3
Go to your ﻿ account Connections page, search for your Notion connection, and click Reauthorize.
You can now see the newly added databases or pages in your Notion ﻿ connection.
Notion modules
After connecting to the Notion app, you can use the following types of modules to build your ﻿. 
Watch Database Items
Get a Database Item
Note: Add the List Page Property Items module to retrieve the complete details of a property item if the output variable contains the has_more value. This means you must paginate to retrieve all the property item's property values in the page object as Notion imposes a 25-page reference limit.
Create a Database Item
Append a Database Item Content
Update a Database Item
Watch Databases/Pages
Search Objects
Get a Database
Get a Page
Create a Database
Create a Page
Update a Database
Update a Page
Watch Page Contents
List Page Contents
List Page Property Items
Get a Page Content
Append a Page Content
Update a Page Content
Note: In the Type field, select the page content type that corresponds to the Page Content ID. If an incorrect Type is selected, an error will appear. The page content type cannot be changed using this module.
Delete a Page Content
List Users
Watch Events
Events will be delivered only for pages connected to your connection. To change the pages with access, create a new connection and select pages in your workspace again.
Make an API Call
List Users
Templates
You can look for Notion templates in Make's template gallery, where you'll find thousands of pre-created ﻿.
Notion resources
﻿Notion API documentation﻿

Field	Value
Redirect URIs	Enter the redirect URI: https://www.integromat.com/oauth/cb/notion2
Company Name	Name of your company or organization. You may use your own name if this does not apply.
Website or homepage	Used to link to your integration’s website or homepage in your integration page and authentication screens.
Tagline	Optional: A short description of the integration.
Privacy policy	URL address used to link to your integration’s privacy policy in your integration page and authentication screens.
Terms of use	URL address used to link to your integration’s terms of use in your integration page and authentication screens
Support email	Used to link to your integration’s support email in your integration page and authentication screens.
Notion URL for optional template	Optional. URL must be for a public Notion page. Use this field if you'd like to duplicate a template into a user's workspace during OAuth.