Notion

11 min

Notion is a productivity and note-taking web application. With the Notion app in Make, you can manage the database items, pages, and page content in your Notion account.

Requirements

To use the Notion app in Make you must have a Notion account. Your Notion account must have admin permissions to establish the connection in Make.

Connect Notion and Make

Make provides two ways to connect to the Notion app:

Internal connectionNotion Internal connection

Public connectionNotion Public connection

To create a Notion internal connection, you first need to:

Obtain the internal integration token in your Notion account.

Create the internal connection in Make.

Obtain the internal integration token in Notion

Before you create the internal connection in Make, you should first obtain an internal integration token in your Notion account.

To obtain the internal integration token:

Click Settings & Members > Connections > Develop or manage integrations from the sidebar or go to the My integrations page.

Click New Integration.

Select the Associate workspace, fill in the integration Name, upload a logo (optional), choose the Associated workspace, and click Submit.

Go to Capabilities, update the requested capabilities, and click Save changes.

Go to Secrets, click Show next to your internal integration token, and copy the token. Store your token in a safe place.

You'll use this value in the Internal Integration Token connection field in Make.

Create the internal connection in Make

Once you have your Notion internal integration token, you're ready to create the connection in Make.

To create the connection:

In the Connection type dropdown, select Notion Internal.

Optional: In the Connection name field, enter a name for the connection.

In the Internal Integration Token field, enter the internal integration token you copied from your Notion account.

Click Save.

You've successfully created the connection and can now use the Notion app in your scenarios. If you want to make changes to your connection in the future, follow the steps here.

To create the public connection:

In the Connection type dropdown, select Notion Public.

Optional: In the Connection name field, enter a name for the connection.

Optional: Click Advanced Settings and enter your client credentials. See Obtain Notion Client CredentialsObtain Notion Client Credentials.

Click Save.

If prompted, authenticate your account, click Select pages, select the pages you want Make to have access to, and click Allow access.

You've successfully created the connection and can now use the Notion app in your scenarios. If you want to make changes to your connection in the future, follow the steps here.

Optional: Obtain Notion client credentials

You can create an advanced connection using your Notion client credentials.

To obtain your Notion client credentials:

Click Settings & Members > Connections > Develop or manage integrations from the sidebar or go to the My integrations page.

Click New Integration.

Select the Associate workspace, fill in the integration Name, upload a logo (optional), choose the Associated workspace, and click Submit.

Go to Capabilities, update the requested capabilities, and click Save changes.

Go to Distribution and click the toggle to make the integration public.

Fill in your organization information and click Submit.

Field	Value
Redirect URIs	Enter the redirect URI: https://www.integromat.com/oauth/cb/notion2
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	URL address 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.
Notion URL for optional 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.

Click Continue in the Switch to Public integration? prompt.

Copy the OAuth client ID and OAuth client secret and save them in a safe place. You will not be able to view the OAuth client secret more than once.

You have successfully created your client credentials.

Notion API update

Starting September 3, 2025, Notion introduced a new API version (2025-09-03) that supports databases with multiple data sources.

Existing integrations

If you already have an existing integration and add a new data source, the old integration will stop working. To continue using the existing integration, delete the newly added data source.

Module compatibility

The new Notion modules work with both single-source and multi-source databases.

For any new setups, use the new modules (not the ones marked as Legacy). This ensures your connection stays compatible with future Notion updates.

Notion API v1 will be deprecated at an unspecified date in the future. To ensure continuity, it is strongly recommended to migrate to the latest version as soon as possible.

Parent identifiers

You can use both old and new modules together as long as they reference the same source database. However, be aware that they require different parent identifiers:

Use database_id for old modules

Use data_source_id for new modules

Module upgrade

While upgrading from old modules to new modules within an existing scenario, there are important breaking changes to account for:

parent.type changes from database to data_source in the new module.

If you are using a v2 module after a v1 module, you will need to map the data_source_id instead of the database_id.

v1 modules do not output the data_source_id, so you'll need to:

retrieve the database using the database_id from the v1 module.

Identify and map the corresponding data_source_id to use in the v2 module.

Instant Event module update

The webhook has been automatically upgraded to the latest version.

The value of parent.type in the webhook output has changed in some cases—from database to data_source. If you reference parent.type in filters or downstream modules, existing mappings may no longer work as expected.

Notion has renamed the database.schema_updated event to data_soure.schema_updated. This change may impact conditions relying on the old event name and will require updates to maintain compatibility.

Add Databases to be visible in Make

For the Notion internal connection, by default, Notion databases do not appear in the Database ID field > Search option. You must manually add them to the Notion app in Make from your Notion account.

To add databases from your Notion account to the Notion app in Make:

Enter into the database you want to add to Make, click on ... in the top right corner, click Add connections, search for and click on the integration you previously created, and click Confirm.

The database is successfully shared and you can now see it in a module's Database ID > Search field.

Retrieve added databases and pages after establishing the connection

If new databases or pages are added to the Notion account, you must revoke the connection in your Notion account and reauthorize the connection in Make to retrieve the added databases or pages.

To retrieve the newly added databases and pages:

Click Settings & members > Connections > ... > Disconnect all users.

Go to your Make account Connections page, search for your Notion connection, and click Reauthorize.

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

Notion modules

After connecting to the Notion app, you can use the following types of modules to build your scenarios.

Templates

You can look for Notion templates in Make's template gallery, where you'll find thousands of pre-created scenarios.

Notion resources

Notion API documentation