Notion credentials

You can use these credentials to authenticate the following nodes:

• Notion
• Notion Trigger

Prerequisites

Create a Notion account with admin level access.

Supported authentication methods

• API integration token: Used for internal integrations.
• OAuth2: Used for public integrations.

Integration type

Not sure which integration type to use? Refer to Internal vs. public integrations below for more information.

Related resources

Refer to Notion's API documentation for more information about the service.

Using API integration token

To configure this credential, you'll need:

• An Internal Integration Secret: Generated once you create a Notion integration.

To generate an integration secret, create a Notion integration and grab the integration secret from the Secrets tab:

1. Go to your Notion integration dashboard.
2. Select the + New integration button.
3. Enter a Name for your integration, for example n8n integration. If desired, add a Logo.
4. Select Submit to create your integration.
5. Open the Capabilities tab. Select these capabilities:
   • Read content
   • Update content
   • Insert content
   • User information without email addresses
6. Be sure to Save changes.
7. Select the Secrets tab.
8. Copy the Internal Integration Token and add it as your n8n Internal Integration Secret.

Refer to the Internal integration auth flow setup documentation for more information about authenticating to the service.

Share Notion page(s) with the integration

For your integration to interact with Notion, you must give your integration page permission to interact with page(s) in your Notion workspace:

1. Visit the page in your Notion workspace.
2. Select the triple dot menu at the top right of a page.
3. In Connections, select Connect to.
4. Use the search bar to find and select your integration from the dropdown list.

Once you share at least one page with the integration, you can start making API requests. If the page isn't shared, any API requests made will respond with an error.

Refer to Integration permissions for more information.

Using OAuth2

To configure this credential, you'll need:

• A Client ID: Generated once you configure a public integration.
• A Client Secret: Generated once you configure a public integration.

You must create a Notion integration and set it to public distribution:

1. Go to your Notion integration dashboard.
2. Select the + New integration button.
3. Enter a Name for your integration, for example n8n integration. If desired, add a Logo.
4. Select Submit to create your integration.
5. Open the Capabilities tab. Select these capabilities:
   • Read content
   • Update content
   • Insert content
   • User information without email addresses
6. Select Save changes.
7. Go to the Distribution tab.
8. Turn on the Do you want 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 to as a Redirect URI in the Notion integration's OAuth Domain & URLs section.
11. Go to the Secrets tab.
12. Copy the Client ID and Client Secret and add them to your n8n credential.

Refer to Notion's public integration auth flow setup for more information about authenticating to the service.

Internal vs. public integrations

Internal integrations are:

• Specific to a single workspace.
• Accessible only to members of that workspace.
• Ideal for custom workspace enhancements.

Internal integrations use a simpler authentication process (the integration secret) and don't require any security review before publishing.

Public integrations are:

• Usable across multiple, unrelated Notion workspaces.
• Accessible by any Notion user, regardless of their workspace.
• Ideal for catering to broad use cases.

Public integrations use the OAuth 2.0 protocol for authentication. They require a Notion security review before publishing.

For a more detailed breakdown of the two integration types, refer to Notion's Internal vs. Public Integrations documentation.