Skip to content

Notion credentials#

You can use these credentials to authenticate the following nodes:

Prerequisites#

Create a Notion account with admin level access.

Supported authentication methods#

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

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

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. Make sure you 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 Get your API secret for more information.

For your integration to interact with Notion, you must share a Notion page with the integration. To share a page with an integration:

  1. Visit the page in your Notion workspace.
  2. Select the ••• menu at the top right of a page.
  3. Scroll down to Add connections.
  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 the Internal integration auth flow setup documentation for further explanation.

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. Make sure you select these capabilities:
    • Read content
    • Update content
    • Insert content
    • User information without email addresses
  6. Be sure to 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 the public integration auth flow setup for further explanation and guidance.