Notion
Connect Notion to RAD Security to enable RADBot to read and create pages in your workspace.
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:
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
Access Integration Settings
- Log in to your Notion workspace
- Visit https://www.notion.com/my-integrations
- You can also access this by clicking Settings & members in your workspace sidebar, then navigating to Connections → Develop or manage integrations
Create New Integration
- Click + New integration
- Enter an Integration name (e.g., "RAD Security" or "RADBot")
- Select the workspace where you want to use the integration
- Click Submit to create the integration
The integration name you choose will be visible when granting page access and in audit logs.
Copy Integration Secret
- After creation, you'll be on the Configuration tab
- Under Internal Integration Secret, click Show to reveal the token
- 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.
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.
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.
Add Integration Connection
- Click the ⋮ (More) menu in the top-right corner of the page
- Scroll down and click + Add connections
- Search for your integration by name (e.g., "RAD Security")
- Click on your integration to select it
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.
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
| Parameter | Description | Example |
|---|---|---|
| Integration Name | A descriptive name for this integration in RAD Security | Notion - Security Docs |
| Internal Integration Secret | The API secret from Step 1 | secret_xxxxxxxxxxxxx |
Navigate to Integrations
Go to your RAD Security workspace and navigate to Data Sources → Integrations → Documentation.
Add Notion Integration
Click Add Integration and select Notion from the available options.
Enter Configuration
- Enter an Integration Name (e.g., "Notion - Security Docs")
- Paste the Internal Integration Secret you copied from Notion
- 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:
Check Integration Status
- Navigate to Data Sources → Integrations → Documentation in RAD Security
- Locate your Notion integration
- Verify the connection status shows as Connected
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:
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
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:
Add Access to New Pages
- Navigate to the page you want to add
- Click ⋮ → + Add connections
- Select your RAD Security integration
- Click Confirm
Remove Access from Pages
- Navigate to the page you want to restrict
- Click ⋮ → Connections
- Find your RAD Security integration
- Click the × to remove the connection
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:
Generate New Secret
- Visit My integrations
- Click on your RAD Security integration
- On the Configuration tab, find Internal Integration Secret
- Click Regenerate secret
- Copy the new secret immediately
Regenerating the secret will immediately invalidate the old one, breaking the connection to RAD Security.
Update RAD Security
- Navigate to your Notion integration in RAD Security
- Click Edit or Update configuration
- Paste the new Internal Integration Secret
- Save the changes
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