Notion

The Notion modules allow you to monitor, create, update, send, retrieve, list, and delete the database items, and databases or pages in your Notion account.

Prerequisites

  • A Notion account - you can create a Notion account at the notion.so/signup.

  • The user account must have admin permission to create a connection.

The module dialog fields that are displayed in bold (in the Makescenario , not in this documentation article) are mandatory!

  1. Go to Make and open the Notion module's Create a connection dialog.

    61d6aa743786d.gif
  2. In the Connection name field, enter a name for the connection and click Continue.

  3. Select the account with which you want to connect, select the workspace and pages, and confirm access to the pages by clicking Allow access.

    61d6aa76ae1a0.png

The connection has been established.

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.

  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.

    61d6aa7c240a0.gif

You can see the newly added databases and pages in your Notion Make connection.

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

Select or map the Database ID whose items you want to watch.

Limit

Set the maximum number of database items Make should return during one execution cycle.

Gets a specified database item.

Connection

Establish a connection to your Notion account.

Get a Database Item

Select or map the database item whose details you want to retrieve.

Database Item ID

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

Creates a new item in a database.

Connection

Establish a connection to your Notion account.

Database ID

Select or map the Database ID for which you want to create the item. When you select the database, dynamic fields related to the database auto-populates. You have to enter the details of the database item. For example, if you are creating a travel plan, fields applicable to the travel plan will appear.

Name

Enter (map) the title of the database item.

Updates an existing database item.

Connection

Establish a connection to your Notion account.

Database ID

Select or map the Database ID whose item details you want to update.

Database Item ID

Select or map the Database Item ID whose details you want to update.

See the Create a Database Item for the field descriptions.

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 should return during one execution cycle.

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.

Filter

Select or map the filters and enter the values to search the object that matches the specified filter. For example, select the filter as Name (Title) and enter the name of the Database ID.

Query Search

Enter a keyword or phrase to search the objects that match the specified query.

Sort

Select or map the order to sort the objects. For example, Last edited time - ascending.

Limit

Set the maximum number of objects Make should return during one execution cycle.

Gets a specified database.

Searches for objects of a page, database, or database item.

Connection

Establish a connection to your Notion account.

Database ID

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

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.

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 should return during one execution cycle.

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 watch.

Limit

Set the maximum number of page contents Make should return during one execution cycle.

Appends a 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 Object

Add the content object:

Type

Select the paragraph type. For example, Heading 1.

Text

Add the text:

Type

Enter (map) the content-type:

  • Text

  • Mention

  • Equation

Content

Enter (map) the text you want to add.

Link

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

Type

Select or map an option that you want to mention:

  • Database

  • Date

  • Page

  • User

User ID

Select or map the User ID you want to mention in the text.

Start

Enter (map) the start date you want to mention in the text. See the list of supported date and time formats.

End

Enter (map) the end date you want to mention in the text. See the list of supported date and time formats.

Page ID

Select or map the Page ID you want to mention in the text.

Database ID

Select or map the Database ID you want to mention in the text.

Expression

Enter (map) the equation you want to add to the text.

Bold

Select whether you want to make the content bold.

Italic

Select whether you want to make the content italic.

Strikethrough

Select whether you want to strikethrough the content.

Underline

Select whether you want to underline the content to bold.

Code

Enter (map) the text that you want to show as code.

Color

Select or map the color of the text or the background of the text.

href

Enter (map) the URL address of an external link or internal Notion that you want to mention in this text.

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

61d6aa812ddea.png

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

In our example, 3 databases were returned:

61d6aa8267fcd.png