Notion
With the Notion modules in Make, you can:
watch, retrieve, create and update the database item
watch, create, update, search, and retrieve database or pages
watch, list, and append page content
To get started with the Notion, create an account at notion.so/signup.
Note
The user account must have admin permission to create a connection.
Connect Notion with Make
Make provides two ways to connect the Notion app:
Establish Notion Internal Connection
To connect the Notion app with the Make:
Log in to your Notion account.
Click Settings & Members > Integrations > Develop your own integrations or alternatively, you can go to https://www.notion.so/my-integrations.
or access the Integrations page directly from the Dashboard page.
Click New Integration > Copy internal integration token.
Copy the Internal Integration Token to your clipboard.
Log in to your Make and add a module from the Notion into a Make scenario.
Click Add next to the Connection field.
In the Connection name field, enter a name for the connection.
In the Internal Integration Token field, enter the details copied in step 3 and click Save.
You have successfully connected the Notion app with Make and can now build scenarios.
If the databases are visible in the Database ID > Search field, follow the instructions in Add Databases to be visible in Make to add them to the Search field.
Establish Notion Public Connection
To establish a Notion public connection:
Log in to your Make account and add a module from the Notion into a Make scenario.
Click Add next to the Connection field.
In the Connection name field, enter a name for the connection. Click Save.
Optional: Click Show Advanced Settings and enter the client credentials. See Obtain Client Credentials.
Click Select pages to grant access to the Make for accessing your Notion account.
Select the pages and confirm the access by clicking Allow access.
You have successfully connected the Notion app with Make and can now build scenarios.
Obtain Client Credentials
To obtain client credentials:
Log in to your Notion account and access the Integrations page or go to Notion's Integration page.
Click New Integration > Public > Create new integration.
Enter a name for the integration, upload an image, select workspace, and capabilities, and click Submit.
In the Integration type section, select Public Integration.
Confirm the Integration type by clicking Continue.
Enter the following details and click Save Changes.
Redirect URIs
Enter the redirect URI:
https://www.integromat.com/oauth/cb/notionCompany 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
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.
URL to Notion 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.
Copy the OAuth Client ID and OAuth Client Secret values to a safe place.
You have successfully retrieved the client credentials.
Add Databases to be visible in Make
For the Notion internal connection, by default, the databases do not appear in the Database ID field > Search option. You need to manually add them to the Make app from your Notion account.
To add databases from your Notion account to Make app:
Log in to your Notion account.
Navigate to the database you want to add to Make and click the ... button on the top right.
In the menu, click three dots > Add connections. A pop-up appears. Search for the integration you have created previously to add the database to Make. For example, Make.
The databases are successfully shared and you can see them in the Database ID > Search field.
Retrieve added databases and pages after establishing the connection
Note
If new pages were added to the Notion account, you must revoke the connection in your Notion account and then in the Make to retrieve the added databases or pages.
To retrieve the newly added databases and pages :
Log in to your Notion account.
Click Settings & Members > Integrations > ... > Disconnect Make.
Go to Make > Connections > Search for Notion connection > Reauthorize.
You can see the newly added databases and pages in your Notion Make connection.
You can watch, create, update, and retrieve the database items using the following modules.
Triggers when a database item is created or updated.
Connection | |
Watch Database Items | Select or map the option to watch the database items:
|
Database ID | Enter (map) the Database ID whose items you want to watch. Alternatively, you can enter a query to search a database. |
Limit | Set the maximum number of database items Make should return during one execution cycle. The default value is 2. |
Gets a specified database item.
Note
Add the List Page/Database Property Items module to retrieve the complete details of the property items if the output variable contains has_more value. This means you need to paginate to retrieve all that property's item's property values in the page object that have a 25-page reference limit. This limitation is added from the Notion side.
Connection | |
Get a Database Item | Select a method:
|
Database Item ID | Enter (map) the Database Item ID whose details you want to retrieve. |
Database ID | Select the Database ID:
|
Database Item ID | Select or map a Database Item ID to retrieve a database item. |
Creates a new item in a database.
Connection | |||||||
Enter Database ID | Select the option to choose the Database ID:
| ||||||
Database ID | Enter (map) the Database ID for which you want to create the database item. Alternatively, you can search for a Database ID. | ||||||
Fields | Enter (map) the details of the fields. For more information, see the property schema objects.
|
Updates an existing database item.
Connection | |||||||
Enter a Database ID | Select the option to choose the Database ID:
| ||||||
Database ID | Enter (map) the Database ID whose item details you want to update. | ||||||
Page ID | Enter (map) the Page ID whose details you want to update. | ||||||
Fields | Enter (map) the details of the fields. For more information, see the property schema objects.
|
You can watch, create, update, and search the databases or pages using the following modules.
Triggers when a database or page is created and updated.
Connection | |
Choose Type of an Object | Select or map the option to watch the objects:
|
Query Search | Enter a keyword or phrase to watch the objects that match the specified query. |
Limit | Set the maximum number of objects Make will return during one execution cycle. The default value is 2. |
Searches for objects of a page, database, or database item.
Connection | |
Search Objects | Select or map the option to search the objects:
|
Database ID | Select or map the Database ID whose objects you want to search. |
Query Search | Enter a keyword or phrase to search the objects that match the specified query. |
Sort | Select the order of sorting for the objects.
|
Limit | Set the maximum number of objects Make will return during one execution cycle. The default value is 10. |
Gets a specified database.
Searches for objects of a page, database, or database item.
Connection | |
Database ID | Enter (map) the Database ID whose details you want to retrieve. Alternatively, you can search for a Database ID. |
Gets a specified page.
Connection | |
Page ID | Select or map the Page ID whose details you want to retrieve. |
Creates a new page on a specified page.
Connection | |||
Create a Page | Select or map a location where you want to create a page:
| ||
Parent Page ID | Select or map a Parent Page ID to which this page belongs. | ||
Get a Database Item | Select a method to retrieve a database item:
| ||
Database Item ID | Enter (map) a Database Item ID whose page you want to create. | ||
Database ID | Select a Database ID. For example, | ||
Database Item ID | Select or map a Database Item ID whose page you want to create. | ||
Title | Enter (map) the page name. | ||
Content Objects | Enter (map) the details of content objects:
| ||
Emoji Icon | Enter (map) an emoji icon for the content object. | ||
Cover URL link | Enter (map) the URL address of the cover to be used for the content object. |
Updates an existing page.
Connection | |
Page ID | Select or map the Page ID whose details you want to update. |
Title | Enter (map) a new name for the page. |
Emoji Icon | Enter (map) an emoji for the content object. |
Cover URL link | Enter (map) the URL address of the cover to be used for the content object. |
Archived | Select whether this page is archived. |
You can watch, list, and append the page content using the following modules.
Triggers when page content is created.
Connection | |
Page ID | Select or map the Page ID whose content you want to watch. |
Limit | Set the maximum number of page contents Make will return during one execution cycle. The default value is 2 |
Retrieves a list of page contents.
Connection | |
Page ID | Select or map the Page ID whose content you want to list. |
Limit | Set the maximum number of page contents Make will return during one execution cycle. The default value is 10. |
Appends new page content.
Connection | |||||
Page ID | Select or map the Page ID whose content you want to append. | ||||
Content Objects | Enter (map) the details of content objects:
|
Retrieves a list of paginated page property items. Possible property types are title, rich_next, relation, and people.
Caution
Use this module, when a property on a database item or page outputs contains has_more value, indicating there are more than 25 items in that field and you need to paginate to retrieve all the items in that column.
Connection | |
Page ID | Select the Page ID whose page or database property item you want to list. |
Property ID | Select or map the Property ID whose items you want to list. |
Other
You can call APIs using the following module.
Performs an arbitrary authorized API call.
Connection | |
URL | Enter a path relative to For the list of available endpoints, refer to the Notion API Documentation. |
Method | Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry. |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
The following API call returns all the databases from your Notion account:
URL:
/v1/databases
Method:
GET
Matches of the search can be found in the module's Output under Bundle > Body > results.
In our example, 2 databases were returned:
