Skip to main content

​
Notion Integration Setup

This guide walks you through connecting Notion to RAD Security, enabling RADBot to read existing pages and create new pages in your Notion workspace for documentation, incident tracking, and knowledge management.

​
Prerequisites

Before you begin, ensure you have:
Workspace Owner or Admin access to your Notion workspace
Access to RAD Security workspace with integration permissions
Understanding of which Notion pages RADBot should have access to
Internal Integration Only: This integration uses Notion’s Internal Integration, which is exclusive to a single workspace and accessible only to its members.

​
Step 1: Create Internal Integration in Notion

1

Access Integration Settings

  1. Log in to your Notion workspace
  2. Visit https://www.notion.com/my-integrations
  3. You can also access this by clicking Settings & members in your workspace sidebar, then navigating to Connections → Develop or manage integrations
2

Create New Integration

  1. Click + New integration
  2. Enter an Integration name (e.g., “RAD Security” or “RADBot”)
  3. Select the workspace where you want to use the integration
  4. Click Submit to create the integration
The integration name you choose will be visible when granting page access and in audit logs.
3

Copy Integration Secret

  1. After creation, you’ll be on the Configuration tab
  2. Under Internal Integration Secret, click Show to reveal the token
  3. Click Copy to copy the secret to your clipboard
Store this secret securely! This token authenticates all API requests and should be kept confidential. You’ll need it to configure the integration in RAD Security.
4

Review Capabilities

On the Capabilities tab, review the default permissions:
  • Read content: Enabled (allows RADBot to read pages)
  • Update content: Enabled (allows RADBot to edit pages)
  • Insert content: Enabled (allows RADBot to create new pages)
These default permissions are required for RADBot to function properly. Do not disable them unless you want to restrict specific capabilities.

​
Step 2: Grant Page Access

After creating the integration, you must explicitly grant it access to specific pages in your workspace.
1

Navigate to a Notion Page

Go to the Notion page (or parent page) you want RADBot to access. This could be:
  • A dedicated “RAD Security” page for incident documentation
  • A team wiki or knowledge base
  • A project management area
Granting access to a parent page automatically grants access to all of its child pages.
2

Add Integration Connection

  1. Click the ⋮ (More) menu in the top-right corner of the page
  2. Scroll down and click + Add connections
  3. Search for your integration by name (e.g., “RAD Security”)
  4. Click on your integration to select it
3

Confirm Access

A confirmation dialog will appear explaining that the integration can access this page and all of its child pages. Click Confirm to grant access.
Be mindful of which pages you grant access to. Only connect pages that RADBot should be able to read and modify.
4

Repeat for Additional Pages (Optional)

If you want RADBot to access multiple separate page hierarchies, repeat the connection process for each parent page.

​
Step 3: Configure in RAD Security

Navigate to your RAD Security workspace and configure the Notion integration:

​
Required Parameters

ParameterDescriptionExample
Integration NameA descriptive name for this integration in RAD SecurityNotion - Security Docs
Internal Integration SecretThe API secret from Step 1secret_xxxxxxxxxxxxx
1

Navigate to Integrations

Go to your RAD Security workspace and navigate to Data Sources → Integrations → Documentation.
2

Add Notion Integration

Click Add Integration and select Notion from the available options.
3

Enter Configuration

  1. Enter an Integration Name (e.g., “Notion - Security Docs”)
  2. Paste the Internal Integration Secret you copied from Notion
  3. Click Save to create the integration
Your integration secret is encrypted and stored securely by RAD Security.

​
Verify Integration

After completing the setup, verify your integration is working:
1

Check Integration Status

  1. Navigate to Data Sources → Integrations → Documentation in RAD Security
  2. Locate your Notion integration
  3. Verify the connection status shows as Connected
2

Test with RADBot

Test the integration by asking RADBot to:
  • Read a page from your connected Notion workspace
  • Create a new page in an accessible area
  • Update an existing page
For example: “RADBot, create a new page in Notion documenting today’s security incident.”
Your Notion integration is now configured! RADBot can read and create pages in your Notion workspace.

​
What RADBot Can Do

Once configured, RADBot can interact with your Notion workspace in the following ways:
  • Retrieve content from any connected page
  • Search across connected pages for information
  • Reference Notion documentation during incident response
  • Access knowledge base articles and runbooks
  • Pull context from project documentation
  • Generate incident documentation automatically
  • Create security reports and summaries
  • Document investigation findings
  • Generate runbooks and procedures
  • Create knowledge base articles from resolved incidents
  • Append updates to existing incident pages
  • Update status and progress information
  • Add findings and remediation steps
  • Cross-reference related incidents
  • Maintain living documentation

​
Use Cases

Automated Incident Documentation

RADBot can automatically create detailed incident documentation pages in Notion, including timeline, affected systems, and remediation steps.

Augment RAD Security Knowledge Base

Connect your existing Notion knowledge base to augment RAD Security’s built-in knowledge with your organization’s custom runbooks, procedures, and security documentation. RADBot can reference this information during incident investigation and response.

Security Reports

Generate comprehensive security reports and summaries directly in your Notion workspace for easy sharing with stakeholders.

Collaborative Investigation

Use Notion’s collaboration features alongside RADBot’s automation to enable team-based incident investigation and documentation.

​
Troubleshooting

Possible causes:
  • Integration not connected to the specific pages
  • Pages are in a different workspace
  • Integration was removed from page connections
Solution:
  • Verify the integration is connected to the pages RADBot is trying to access
  • Check the page’s connections via the ⋮ menu → Connections
  • Re-add the integration connection if it was removed
  • Ensure the pages are in the same workspace as the integration
Possible causes:
  • Integration secret is incorrect
  • Integration was deleted in Notion
  • Token was regenerated
Solution:
  • Verify the secret is copied correctly (no extra spaces)
  • Check that the integration still exists in My integrations
  • If the integration was deleted, create a new one and update RAD Security
  • Generate a new secret if needed and update the configuration
Possible causes:
  • Insert content capability is disabled
  • Integration doesn’t have access to the parent page
  • Workspace permissions changed
Solution:
  • Check the integration’s Capabilities tab in Notion
  • Ensure Insert content is enabled
  • Verify the integration is connected to the parent page where new pages should be created
  • Check workspace member permissions allow integration usage
Possible causes:
  • Integration exists in a different workspace
  • Integration was deleted
  • Search query doesn’t match integration name
Solution:
  • Verify you’re in the correct workspace when adding connections
  • Check My integrations to see all integrations
  • Search using the exact integration name
  • Create a new integration if the original was deleted

​
Security Best Practices

Limit Page Access

Only grant the integration access to pages that RADBot needs. Use a dedicated parent page for security documentation rather than connecting your entire workspace.

Secure Token Storage

Store the Internal Integration Secret securely in RAD Security. Never commit it to version control or share via insecure channels.

Regular Access Audits

Periodically review which pages the integration has access to and remove connections to pages that are no longer needed.

Monitor Integration Activity

Review pages created and modified by the integration in Notion’s activity log to ensure appropriate usage.

Use Descriptive Names

Name your integration clearly (e.g., “RAD Security Bot”) so team members understand its purpose when they see it in page connections.

Workspace-Specific Integrations

Create separate integrations for different Notion workspaces if your organization uses multiple workspaces.

​
Managing Page Permissions

To modify which pages RADBot can access:
1

Add Access to New Pages

  1. Navigate to the page you want to add
  2. Click ⋮ → + Add connections
  3. Select your RAD Security integration
  4. Click Confirm
2

Remove Access from Pages

  1. Navigate to the page you want to restrict
  2. Click ⋮ → Connections
  3. Find your RAD Security integration
  4. Click the × to remove the connection
3

View All Connected Pages

Unfortunately, Notion doesn’t provide a centralized view of all pages an integration has access to. Consider creating a dedicated parent page for RAD Security content to simplify management.

​
Token Rotation

To rotate your Notion integration secret:
1

Generate New Secret

  1. Visit My integrations
  2. Click on your RAD Security integration
  3. On the Configuration tab, find Internal Integration Secret
  4. Click Regenerate secret
  5. Copy the new secret immediately
Regenerating the secret will immediately invalidate the old one, breaking the connection to RAD Security.
2

Update RAD Security

  1. Navigate to your Notion integration in RAD Security
  2. Click Edit or Update configuration
  3. Paste the new Internal Integration Secret
  4. Save the changes
3

Verify Connection

Test that the integration still works by asking RADBot to read or create a page in Notion.

​
Additional Resources

Build your first integration

Official Notion guide to creating internal integrations

Notion API Documentation

Learn about Notion’s API capabilities and endpoints

Add & manage integrations

Notion Help Center guide for managing API connections

Notion API integrations

Overview of Notion API integrations and use cases

​
Next Steps

RADBot

Learn more about RADBot and its capabilities

Knowledge Base

Explore how RAD Security uses knowledge management

Evidence Room

View security data and incident evidence

AI Workers

Discover other AI-powered automation capabilities