Notion Connector

The Notion connector indexes databases, pages, and comments across your Notion workspace.

Create the Notion integration

As an administrator, you can either follow the steps below or navigate directly to My Integrations:

1. Click on Settings & members.
2. Under Workspace, click on Connections.
3. Click the link for Develop or manage integrations.

Create a new Internal integration by following the steps below:

1. Choose the associated workspace and give it an appropriate name, e.g. Atolio.
2. (Optional) Use the Atolio logo here, if needed.
3. Under Secrets, copy the Internal Integration Secret. You’ll provide it as described in Required Configuration Values.
4. Under Capabilities:

• Only “Read content” and “Read comments” are necessary. The other permissions can be removed.
• Ensure that “Read user information including email addresses” is enabled.
• Click Save changes.

Required Configuration Values

Enter these values in the Atolio Admin console (v4.24 and later), or send them to Atolio Support (your Deployment Engineer).

Keep secrets secure: Share values marked “Yes” in the Secret column only through a password-manager share (e.g. 1Password) or another secure channel agreed with Atolio Support. Never send them in plain email, chat, or support tickets.

Configuration Example

Add this block to connector-values.yaml. Replace each <PLACEHOLDER> with the matching value from the table above, and remove any line marked “Only if” that doesn’t apply.

connectors:
  notion:
    default:
      notion:
        connector: notion
        instance: default
        source: notion
        common:
          enabled: true
          identity-provider: false
        secrets:
          token:
            value: "<INTERNAL_INTEGRATION_SECRET>"
        configuration: {}