Notion

Notion is an all-in-one workspace for notes, tasks, wikis, and databases.

Authentication Types

Notion supports 3 authentication methods:

• OAuth - Create your own Notion integration with custom capabilities. Every user connects with their Notion account.

  • Pros: Full control, per-user tracking, production-ready
  • Cons: ~2 min setup

• Instant OAuth - Use Webrix's pre-configured Notion integration for the fastest setup.

  • Pros: Fastest setup, no configuration needed
  • Cons: Limited capabilities, not recommended for production

• API Key - Use an internal integration token for all users.

  • Pros: Easy setup
  • Cons: Less secure, no per-user tracking

Setting up OAuth

1. Go to https://www.notion.so/my-integrations

2. Click + New integration

3. Fill in the details:
   • Name: Give it a descriptive name
   • Associated workspace: Select your workspace
   • Type: Select Public

4. Click Submit

5. Go to the Distribution tab

6. Toggle on Make integration public

7. Fill in the required information:
   • Redirect URIs: Copy the Redirect URL from Webrix and paste it here
   • Company name, Website, etc.

8. Click Submit

9. Go to the Secrets tab

10. Copy the OAuth client ID and OAuth client secret

11. In Webrix, paste the Client ID and Client Secret

12. Select the capabilities (scopes) you need in Webrix

13. Click Save Changes

Generating an API Key (Internal Integration)

1. Go to https://www.notion.so/my-integrations

2. Click + New integration

3. Fill in the details:

   • Name: Give it a descriptive name
   • Associated workspace: Select your workspace
   • Type: Select Internal (default)

4. Select the Capabilities (permissions) you need

5. Click Submit

6. Copy the Internal Integration Secret (starts with secret_)

7. Paste the token into Webrix

Important: For internal integrations, you must share the specific pages/databases with the integration in Notion for it to access them.