Notion
Tag
- 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 an integration secret, create a concept integration and import the integration secret from the Secrets tab:
1.
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 on service authentication, please refer to the Internal Integrated Authentication Flow Setup document .
Share concept pages through integration
For the integration to interact with Notion, you must grant the integration page permission to interact with pages in the 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.
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.
1.
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 integrated 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.