Prerequisites

Access to Notion Beta API program

Currently, the Notion API is in Private Beta. Only selected users who are part of the beta program have access to the APIs and can use Notion integration on Automate.io.

If you can’t find the ‘API’ section in your workspace, then you are likely not part of it. Please get in touch with the Notion team to get access to API.


Connecting Notion with Automate.io

Connecting your Notion account to Automate.io requires you to have the bot token. Please follow below instruction to fetch the bot token from your Notion account.

1. Go to 'Settings & Members' (in your Notion account) > 'API'.

2. Copy the token from your Notion and paste it in the authentication window as shown in below screenshot.


Triggers

⚡️ New Item (Page)

Description: Triggers when there is a new item/page created in the specified database. You would need to provide the Database ID in which the Bot will look for new items/pages.

Note: You would need to share the Database selected with the Bot User. To do this, click on ‘Share’ on the top right corner of the database page. Ensure that the ‘Automate.io’ bot has write access to the database.

⚡️ Updated Item (Page)

Description: Triggers when there is a modification to an existing item/page in the specified database. You would need to provide the Database ID in which the Bot will look for changes to the existing items/pages.

Note: You would need to share the Database selected with the Bot User. To do this, click on ‘Share’ on the top right corner of the database page. Ensure that the ‘Automate.io’ bot has write access to the database.


How to get Database ID?

You can fetch the Database ID from the URL of that page in your Notion app. For example, if the Database page URL is "https://www.notion.so/workspace/XXX?v=YYY", then the ID of Database would be XXX.

How to get Page ID?

You can fetch the Page ID from the URL of that item in your Notion app. For example, if the Page URL is "https://www.notion.so/workspace/XXX?v=YYY&p=ZZZ", then the ID of Page would be ZZZ.


Actions

✅ Add Item (Page)

Description: This action can be used to update an existing item/page present in the specified Database. You would need the Database ID of the page in which the Bot will look add new item/page.

✅ Update Item (Page)

Description: This action can be used to update an existing item/page present in the specified Database and Page.

You would need to provide the Database ID and Page ID of the page that you wish to update. You can use the Search Page action to get the Page ID, and then use Update Item action.

Note: You can choose not to use Page ID and update the item using its title instead. It does support partial match of the title however, is case-sensitive.

✅ Search Item (Page)

Description: This action can be used to search for the page using Page ID or Title in a specified database.

✅ Search Member

Description: This action can be used to search for a member and fetch their details from your Notion account. This can be done using their email or name of the member. Searching by name supports partial match however, is case-sensitive.


Common issues with Notion integration

❗️ I am unable to find Bot Token in my Notion account.

Currently, the Notion API is in Private Beta. Only selected users who are part of the beta program have access to the APIs and can use Notion integration on Automate.io. If you can’t find the ‘API’ section in your workspace, then you are likely not a part of it. Please get in touch with the Notion team to get access to API.

Did this answer your question?