Notion

Tag
  1. API
Name
Notion

Use API integration tokens (Recommended)

To configure these credentials, you will need:
Internal Integration Secret :
It is created when you create a Notion integration.
To create a unified secret, create a concept unified and retrieve the unified secret from the Secrets tab:
1.
Go to the Notion integrated dashboard .
2.
+ Select the New Integration button.
3.
For example, enter the name of the integration: n8n integration
. Add a logo if you want.
4.
Select Submit to create the integration.
5.
Open the Features tab. Select the following features:
Read content
Update content
Insert content
User information without email addresses
6.
You must save your changes .
7.
Select the Secrets tab.
8.
Copy the Internal Integration Token and add it as the n8n Internal Integration Secret .
For more information about service authentication, see the Setting up an internal integrated authentication flow document .

Share concept pages through integration

For the integration to interact with Notion, you need to grant the integration page permission to interact with pages in your Notion workspace :
1.
Visit the page in your Notion workspace.
2.
Select the triple dot menu at the top right of the page.
3.
In Connections , select the connection target .
4.
Use the search bar to find and select Integration from the drop-down list.
If you share one or more pages with the integration, you can initiate an API request. If the pages are not shared, an API request will respond with an error.
For more information, see Unified Permissions .

Using OAuth2 #

To configure these credentials, you will need:
Client ID : Generated when you configure public integration.
Customer Secrets :
It is created when you configure a public integration.
You need to create a Notion integration and set it for public distribution:
1.
Go to the Notion integrated dashboard .
2.
+ Select the New Integration button.
3.
For example, enter the name of the integration: n8n integration
. Add a logo if you want.
4.
Select Submit to create the integration.
5.
Open the Features tab. Select the following features:
Read content
Update content
Insert content
User information without email addresses
6.
Select Save Changes .
7.
Go to the Distribution tab.
8.
Would you like to make this integration public?
Control.
9.
Enter your company name and website in the Organization Information section.
10.
Copy the n8n OAuth redirect URL and add it as a Redirect URI in the OAuth Domains and URLs section of your Notion integration.
11.
Go to the Secrets tab.
12.
Copy the Client ID and Client Secret and add them to your n8n credentials.
For more information about service authentication, see Setting up Notion's public unified authentication flow .
You can check it at the link below

Internal integration and public integration

The internal integration is as follows:
Applies to a single workspace only.
Only members of that workspace can access it.
Ideal for improving your personalized workspace.
Internal integrations use a simpler authentication process (integrated secrets) and do not require security review prior to publishing.
Public integration is as follows:
Can be used across multiple, unrelated Notion workspaces.
Accessible to all Notion users, regardless of workspace.
Ideal for meeting a wide range of use cases.
Public integrations use the OAuth 2.0 protocol for authentication and require Notion security review before publishing.