> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rad.security/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect Notion to RAD Security to enable RADBot to read and create pages in your workspace.

# 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:

<Check>Workspace Owner or Admin access to your Notion workspace</Check>
<Check>Access to RAD Security workspace with integration permissions</Check>
<Check>Understanding of which Notion pages RADBot should have access to</Check>

<Info>
  **Internal Integration Only:** This integration uses Notion's Internal Integration, which is exclusive to a single workspace and accessible only to its members.
</Info>

***

## Step 1: Create Internal Integration in Notion

<Steps>
  <Step title="Access Integration Settings">
    1. Log in to your Notion workspace
    2. Visit [https://www.notion.com/my-integrations](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**
  </Step>

  <Step title="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

    <Note>
      The integration name you choose will be visible when granting page access and in audit logs.
    </Note>
  </Step>

  <Step title="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

    <Warning>
      **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.
    </Warning>
  </Step>

  <Step title="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)

    <Note>
      These default permissions are required for RADBot to function properly. Do not disable them unless you want to restrict specific capabilities.
    </Note>
  </Step>
</Steps>

***

## Step 2: Grant Page Access

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

<Steps>
  <Step title="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

    <Info>
      Granting access to a parent page automatically grants access to all of its child pages.
    </Info>
  </Step>

  <Step title="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
  </Step>

  <Step title="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.

    <Warning>
      Be mindful of which pages you grant access to. Only connect pages that RADBot should be able to read and modify.
    </Warning>
  </Step>

  <Step title="Repeat for Additional Pages (Optional)">
    If you want RADBot to access multiple separate page hierarchies, repeat the connection process for each parent page.
  </Step>
</Steps>

***

## 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`   |

<Steps>
  <Step title="Navigate to Integrations">
    Go to your RAD Security workspace and navigate to **Data Sources** → **Integrations** → **Documentation**.
  </Step>

  <Step title="Add Notion Integration">
    Click **Add Integration** and select **Notion** from the available options.
  </Step>

  <Step title="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
  </Step>
</Steps>

<Note>
  Your integration secret is encrypted and stored securely by RAD Security.
</Note>

***

## Verify Integration

After completing the setup, verify your integration is working:

<Steps>
  <Step title="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**
  </Step>

  <Step title="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."
  </Step>
</Steps>

<Check>
  Your Notion integration is now configured! RADBot can read and create pages in your Notion workspace.
</Check>

***

## What RADBot Can Do

Once configured, RADBot can interact with your Notion workspace in the following ways:

<AccordionGroup>
  <Accordion title="Read Existing Pages" icon="book-open">
    * 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
  </Accordion>

  <Accordion title="Create New Pages" icon="file-plus">
    * Generate incident documentation automatically
    * Create security reports and summaries
    * Document investigation findings
    * Generate runbooks and procedures
    * Create knowledge base articles from resolved incidents
  </Accordion>

  <Accordion title="Update Pages" icon="pen-to-square">
    * Append updates to existing incident pages
    * Update status and progress information
    * Add findings and remediation steps
    * Cross-reference related incidents
    * Maintain living documentation
  </Accordion>
</AccordionGroup>

***

## Use Cases

<CardGroup cols={2}>
  <Card title="Automated Incident Documentation" icon="file-medical">
    RADBot can automatically create detailed incident documentation pages in Notion, including timeline, affected systems, and remediation steps.
  </Card>

  <Card title="Augment RAD Security Knowledge Base" icon="brain">
    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.
  </Card>

  <Card title="Security Reports" icon="chart-line">
    Generate comprehensive security reports and summaries directly in your Notion workspace for easy sharing with stakeholders.
  </Card>

  <Card title="Collaborative Investigation" icon="users">
    Use Notion's collaboration features alongside RADBot's automation to enable team-based incident investigation and documentation.
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="RADBot Cannot Access Pages" icon="lock">
    **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
  </Accordion>

  <Accordion title="Authentication Failed" icon="triangle-exclamation">
    **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](https://www.notion.com/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
  </Accordion>

  <Accordion title="Cannot Create Pages" icon="file-circle-xmark">
    **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
  </Accordion>

  <Accordion title="Integration Not Found" icon="magnifying-glass-minus">
    **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](https://www.notion.com/my-integrations) to see all integrations
    * Search using the exact integration name
    * Create a new integration if the original was deleted
  </Accordion>
</AccordionGroup>

***

## Security Best Practices

<CardGroup cols={2}>
  <Card title="Limit Page Access" icon="shield-halved">
    Only grant the integration access to pages that RADBot needs. Use a dedicated parent page for security documentation rather than connecting your entire workspace.
  </Card>

  <Card title="Secure Token Storage" icon="lock">
    Store the Internal Integration Secret securely in RAD Security. Never commit it to version control or share via insecure channels.
  </Card>

  <Card title="Regular Access Audits" icon="clipboard-list">
    Periodically review which pages the integration has access to and remove connections to pages that are no longer needed.
  </Card>

  <Card title="Monitor Integration Activity" icon="chart-line">
    Review pages created and modified by the integration in Notion's activity log to ensure appropriate usage.
  </Card>

  <Card title="Use Descriptive Names" icon="tag">
    Name your integration clearly (e.g., "RAD Security Bot") so team members understand its purpose when they see it in page connections.
  </Card>

  <Card title="Workspace-Specific Integrations" icon="building">
    Create separate integrations for different Notion workspaces if your organization uses multiple workspaces.
  </Card>
</CardGroup>

***

## Managing Page Permissions

To modify which pages RADBot can access:

<Steps>
  <Step title="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**
  </Step>

  <Step title="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
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## Token Rotation

To rotate your Notion integration secret:

<Steps>
  <Step title="Generate New Secret">
    1. Visit [My integrations](https://www.notion.com/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

    <Warning>
      Regenerating the secret will immediately invalidate the old one, breaking the connection to RAD Security.
    </Warning>
  </Step>

  <Step title="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
  </Step>

  <Step title="Verify Connection">
    Test that the integration still works by asking RADBot to read or create a page in Notion.
  </Step>
</Steps>

***

## Additional Resources

<CardGroup cols={2}>
  <Card title="Build your first integration" icon="book" href="https://developers.notion.com/docs/create-a-notion-integration">
    Official Notion guide to creating internal integrations
  </Card>

  <Card title="Notion API Documentation" icon="code" href="https://developers.notion.com/docs/getting-started">
    Learn about Notion's API capabilities and endpoints
  </Card>

  <Card title="Add & manage integrations" icon="plug" href="https://www.notion.com/help/add-and-manage-connections-with-the-api">
    Notion Help Center guide for managing API connections
  </Card>

  <Card title="Notion API integrations" icon="circle-info" href="https://www.notion.com/help/create-integrations-with-the-notion-api">
    Overview of Notion API integrations and use cases
  </Card>
</CardGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="RADBot" icon="robot" href="/rad-security/getting-started/radbot">
    Learn more about RADBot and its capabilities
  </Card>

  <Card title="Knowledge Base" icon="brain" href="/rad-security/platform/knowledge-base">
    Explore how RAD Security uses knowledge management
  </Card>

  <Card title="Evidence Room" icon="vault" href="/rad-security/platform/evidence-room">
    View security data and incident evidence
  </Card>

  <Card title="AI Workers" icon="sparkles" href="/rad-security/getting-started/ai-workers">
    Discover other AI-powered automation capabilities
  </Card>
</CardGroup>