Skip to content

Notion

With the Notion modules in Ibexa Connect, 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.

Note

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

Connect Notion with Ibexa Connect

Ibexa Connect provides two ways to connect the Notion app:

Establish Notion Internal Connection

To connect the Notion app with the Ibexa Connect:

  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

  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 Ibexa Connect and add a module from the Notion into a Ibexa Connect 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 Ibexa Connect 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 the Ibexa Connect to add them to Search field.

Establish Notion Public Connection

To establish a Notion public connection:

  1. Log in to your Ibexa Connect account and add a module from the Notion into a Ibexa Connect 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. Click Select pages to grant access to the Ibexa Connect for accessing your Notion account.

    Notion_4.png

  5. Select the pages and confirm the access by clicking Allow access.

    Notion_5.png

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

Add Databases to be visible in the Ibexa Connect

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 Ibexa Connect app from your Notion account.

msedge_xN4IuRm1rS.gif

To add databases from your Notion account to Ibexa Connect app:

  1. Log in to your Notion account.

  2. Navigate to the database you want to add to Ibexa Connect, click Share > Invite.

    UjnXE2Lbfz.png

  3. Select the workspace and click Invite. You can multiple databases.

    Swkxyisv9k.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 Ibexa Connect 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 Ibexa Connect.

    61d6aa785af71.gif

  3. Go to Ibexa Connect > Connections > Search for Notion connection > Reauthorize.

    msedge_2Ufl0UimNc.gif

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

Database Item

You can watch, create, update, and retrieve the database items using the following modules.

Watch Database Items

Triggers when a database item is created or updated.

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 query to search a database.

Limit

Set the maximum number of database items Ibexa Connect should return during one execution cycle. The default value is 2.

Get a Database Item

Gets a specified database item.

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.

Create a Database Item

Creates a new item in a database.

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.

Update a Database Item

Updates an existing database item.

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.

Database/Page

You can watch, create, update, and search the databases or pages using the following modules.

Watch Databases/Pages

Triggers when a database or page is created and updated.

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 Ibexa Connect will return during one execution cycle. The default value is 2.

Search Objects

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

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 Ibexa Connect will return during one execution cycle. The default value is 10.

Get a Database

Gets a specified database.

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

Database ID Enter (map) the Database ID whose details you want to retrieve. Alternatively, you can search for a Database ID.

Get a Page

Gets a specified page.

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

Create a Page

Creates a new page on a specified page.

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.

Update a Page

Updates an existing page.

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.

Page Content

You can watch, list, and append the page content using the following modules.

Watch Page Content

Triggers when page content is created.

Page ID Select or map the Page ID whose content you want to watch.
Limit Set the maximum number of page contents Ibexa Connect will return during one execution cycle. The default value is 2

List Page Contents

Retrieves a list of page contents.

Page ID Select or map the Page ID whose content you want to list.
Limit Set the maximum number of page contents Ibexa Connect will return during one execution cycle. The default value is 10.

Append a Page Content

Appends a new page content.

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.

Other

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized API call.

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.

Example of Use - List Databases

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