Skip to main content

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:

  1. Log in to your Notion account.

  2. Click Settings & Members > Integrations > Develop your own integrations or alternatively, you can go to https://www.notion.so/my-integrations.

    msedge_lN1Rtu9L9Q.gif

    or access the Integrations page directly from the Dashboard page.

    PazOuz3VmL.png
  3. Click New Integration > Copy internal integration token.

    VCI43IGUNq.png
  4. Copy the Internal Integration Token to your clipboard.

    msedge_KCPRoxY5R2.png
  5. Log in to your Make and add a module from the Notion into a Make scenario.

  6. Click Add next to the Connection field.

    Notion_6.gif
  7. In the Connection name field, enter a name for the connection.

  8. 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:

  1. Log in to your Make account and add a module from the Notion into a Make scenario.

  2. Click Add next to the Connection field.

    msedge_G4nGnb7l39.gif
  3. In the Connection name field, enter a name for the connection. Click Save.

  4. Optional: Click Show Advanced Settings and enter the client credentials. See Obtain Client Credentials.

  5. Click Select pages to grant access to the Make for accessing your Notion account.

    Notion_4.png
  6. Select the pages and confirm the access by clicking Allow access.

    Notion_5.png

You have successfully connected the Notion app with Make and can now build scenarios.

Obtain Client Credentials

To obtain client credentials:

  1. Log in to your Notion account and access the Integrations page or go to Notion's Integration page.

  2. Click New Integration > Public > Create new integration.

    msedge_UJiIgFeGru.png
  3. Enter a name for the integration, upload an image, select workspace, and capabilities, and click Submit.

    rjcksAEXP8.png
  4. In the Integration type section, select Public Integration.

    msedge_h9Cu5lBzy0.png
  5. Confirm the Integration type by clicking Continue.

    msedge_j5f7ONjGGo.png
  6. Enter the following details and click Save Changes.

    msedge_k2aKcjmiR9.png

    Redirect URIs

    Enter the redirect URI:

    https://www.integromat.com/oauth/cb/notion

    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

    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.

  7. Copy the OAuth Client ID and OAuth Client Secret values to a safe place.

    msedge_37yBoPGnt8.png

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.

msedge_xN4IuRm1rS.gif

To add databases from your Notion account to Make app:

  1. Log in to your Notion account.

  2. Navigate to the database you want to add to Make and click the ... button on the top right.

    UjnXE2Lbfz.png
  3. 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.

    Screenshot_2023-01-10_at_8_18_08_AM.png

The databases are successfully shared and you can see them in the Database ID > Search field.

p3nnx3BAli.png

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 :

  1. Log in to your Notion account.

  2. Click Settings & Members > Integrations > ... > Disconnect Make.

    61d6aa785af71.gif
  3. Go to Make > Connections > Search for Notion connection > Reauthorize.

    msedge_2Ufl0UimNc.gif

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

Establish a connection to your Notion account.

Watch Database Items

Select or map the option to watch the database items:

  • By Created Time

  • By Updated Time

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

Establish a connection to your Notion account.

Get a Database Item

Select a method:

  • Enter manually

  • Select from the list

Database Item ID

Enter (map) the Database Item ID whose details you want to retrieve.

Database ID

Select the Database ID:

  • Journal

  • Task List

  • Recipes

  • Travels Plans

  • Media

Database Item ID

Select or map a Database Item ID to retrieve a database item.

Creates a new item in a database.

Connection

Establish a connection to your Notion account.

Enter Database ID

Select the option to choose the Database ID:

  • Enter manually

  • Select from the list

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.

Key

Enter (map) the name of a field.

Value Type

Select or map the value type.

Value

Enter (map) the input value of a field.

Updates an existing database item.

Connection

Establish a connection to your Notion account.

Enter a Database ID

Select the option to choose the Database ID:

  • Enter manually

  • Select from the list

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.

Key

Enter (map) the name of a field.

Value Type

Select or map the value type.

Value

Enter (map) the input value of a field.

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

Establish a connection to your Notion account.

Choose Type of an Object

Select or map the option to watch the objects:

  • Databases

  • Pages

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

Establish a connection to your Notion account.

Search Objects

Select or map the option to search the objects:

  • Database Items

  • Databases

  • Pages

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.

  • Last edited time - Ascending

  • Last edited time - Descending

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

Establish a connection to your Notion account.

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

Establish a connection to your Notion account.

Page ID

Select or map the Page ID whose details you want to retrieve.

Creates a new page on a specified page.

Connection

Establish a connection to your Notion account.

Create a Page

Select or map a location where you want to create a page:

  • Into a Parent Page

  • Into a Database Item

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:

  • Enter manually

  • Select from the list

Database Item ID

Enter (map) a Database Item ID whose page you want to create.

Database ID

Select a Database ID. For example, Media.

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:

Type

Select or map the content type. For example, paragraph.

  • Text: Enter (map) the text details:

    • Content: Enter (map) the content to be displayed.

    • Link: Enter (map) a URL address to the text which you want to add here.

  • Mention: Select an option that you want to mention and enter its value. For example, the user.

    • Date: Enter the start and end date to apply the mention values

  • Equation: Enter (map) the expression of the equation.

  • Annotations: Apply the annotations to the content:

    • Bold: Select whether to make the text bold.

    • Italic: Select whether to make the text italic.

    • Strikethrough: Select whether to strikethrough the text.

    • Underline: Select whether to underline the text.

    • Code: Select whether to make the text as code.

    • Color: Select or map the color for the text or the background of the text.

  • href: Enter (map) the URL of any link or internal Notion mentioned in this text.

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

Establish a connection to your Notion account.

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

Establish a connection to your Notion account.

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

Establish a connection to your Notion account.

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

Establish a connection to your Notion account.

Page ID

Select or map the Page ID whose content you want to append.

Content Objects

Enter (map) the details of content objects:

Type

Select the content type. For example, paragraph.

Text

Enter (map) the text details. You can add multiple content types.

  • Type: Select or map the content type. For example, equation.

  • Text: Enter (map) the text details:

    • Content: Enter (map) the content to be displayed.

    • Link: Enter (map) a URL address to the text which you want to add here.

  • Mention: Select an option that you want to mention and enter its value. For example, the user.

    • Date: Enter the start and end date to apply the mention.

  • Equation: Enter (map) the expression of the equation.

  • Annotations: Apply the annotations to the content:

    • Bold: Select whether to make the text bold.

    • Italic: Select whether to make the text italic.

    • Strikethrough: Select whether to strikethrough the text.

    • Underline: Select whether to underline the text.

    • Code: Select whether to make the text as code.

    • Color: Select or map the color for the text or the background of the text.

  • href: Enter (map) the URL of any link or internal Notion mentioned in this text.

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

Establish a connection to your Notion account.

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

Establish a connection to your Notion account.

URL

Enter a path relative to https://api.notion.com. For example, /v1/search.

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

Notion_1.png

Matches of the search can be found in the module's Output under Bundle > Body > results.

In our example, 2 databases were returned:

Notion_2.png