Notion Integration
Connect your Notion workspace to aura for seamless knowledge management
Notion Integration
Transform how you work with your Notion workspace by connecting it to aura. Search, create, and manage your Notion pages and databases using natural language, all while maintaining complete control over your data.
What You Can Do
Intelligent Search
- Natural Language Search: Find Notion pages and databases using conversational queries
- Cross-Workspace Search: Search across all your Notion workspaces from a single interface
- Content Discovery: Find information buried deep in your Notion hierarchy
- Semantic Understanding: Search by meaning, not just keywords
Page Management
- Create Pages: Generate new Notion pages with AI-powered content
- Update Pages: Modify existing pages directly from aura
- Read Content: View page content without leaving aura
- Organize Information: Manage your Notion structure efficiently
Database Operations
- Database Search: Query Notion databases with natural language
- Create Entries: Add new database items through aura
- Update Records: Modify database entries seamlessly
- Filter & Sort: Find specific database items quickly
Content Integration
- Cross-Platform Links: Connect Notion pages with emails, tasks, and projects
- Unified Knowledge: Access Notion content alongside other integrations
- Smart References: Link information across all your connected tools
- Contextual Insights: Get relevant Notion content in your searches
Privacy-First Architecture
Zero Data Storage on aura
Important: Unlike email integrations, aura does not store any of your Notion content on our servers.
How It Works:
- aura connects to Notion in real-time using secure APIs
- All searches query Notion directly through their API
- Content is retrieved on-demand when you search
- No caching or permanent storage of your Notion data
- Your pages and databases remain exclusively in Notion
What This Means for You:
- Complete Privacy: Your Notion content never leaves Notion's servers
- Always Current: Search results reflect the latest content in real-time
- No Sync Required: No waiting for data synchronization
- Instant Updates: Changes in Notion are immediately searchable
- Zero Risk: Even if you disconnect, no data remains in aura
Security & Access Control
Secure Connection:
- OAuth 2.0 authentication (no passwords stored)
- Encrypted API communication (TLS/SSL)
- Token-based access that you can revoke anytime
- Industry-standard security protocols
Permission Inheritance:
- aura only accesses pages you have permission to view
- Respects Notion's sharing and permission settings
- Cannot access private pages you don't own
- Honors workspace-level restrictions
Data Protection:
- No Notion content stored in aura databases
- No caching of page content
- No indexing of your Notion data
- API tokens encrypted and securely stored
- Complete data sovereignty maintained
Prerequisites
Before connecting Notion to aura, ensure you have:
- Notion Account: An active Notion account (free or paid)
- Workspace Access: Access to the Notion workspace(s) you want to search
- Permissions: Ability to create integrations in your Notion workspace
- API Token: A Notion integration token with appropriate permissions
Connection Setup
Step 1: Create a Notion Integration
- Go to Notion Integrations
- Click "New integration" or "+ Create new integration"
- Fill in the integration details:
- Name: "aura Integration" (or your preferred name)
- Associated workspace: Select your workspace
- Logo: Optional - upload a logo if desired
- Click "Submit" to create the integration
Step 2: Configure Integration Capabilities
- In your integration settings, configure the following capabilities:
- Read content: Enable (required for searching)
- Update content: Enable (optional, for editing pages)
- Insert content: Enable (optional, for creating pages)
- Set the integration type:
- Choose "Internal" for personal use
- Choose "Public" if sharing with team
- Save your changes
Step 3: Copy Your Integration Token
- In the integration settings page, find "Internal Integration Token"
- Click "Show" then "Copy" to copy the token
- The token starts with
secret_ - Keep this token secure - it provides access to your Notion workspace
Important: This token is like a password. Never share it publicly or commit it to version control.
Step 4: Share Pages with Your Integration
Notion integrations need explicit access to pages:
- Open a Notion page you want to search
- Click the "•••" menu in the top right
- Scroll down and click "Add connections"
- Find and select your "aura Integration"
- Click "Confirm"
- Repeat for other pages or databases you want to access
Tip: Share your integration with parent pages to automatically grant access to all child pages.
Step 5: Connect in aura
- Navigate to the Integrations page in aura
- Find "Notion" and click "Connect & Configure"
- You'll see two tabs: "Info" and "Settings"
- Click on the "Settings" tab
- Paste your Integration Token in the "API Token" field
- Click "Connect Notion"
- Wait for the connection to be established
- Return to your dashboard to verify the status shows "Connected"
Understanding Connection Status
✅ Connected
Your Notion integration is working properly. You can:
- Search all pages shared with your integration
- View page content in real-time
- Create new pages (if enabled)
- Update existing pages (if enabled)
- Query databases and create entries
⚠️ Not Connected
The integration hasn't been set up yet. Follow the connection setup steps above.
⚠️ Token Invalid
Your integration token is no longer valid:
Why this happens:
- Token was regenerated in Notion
- Integration was deleted
- Token was manually revoked
- Workspace permissions changed
How to fix:
- Go to Notion Integrations
- Find your integration
- Copy the current token (or create a new integration)
- Update the token in aura's Notion integration settings
- Click "Update Notion"
Using the Notion Integration
Searching Pages
Use natural language to find Notion pages:
Examples:
- "Find my meeting notes from last week"
- "Show me pages about the Q4 project"
- "Search for the product roadmap"
- "Find pages tagged with 'marketing'"
- "Show me all pages in the Engineering workspace"
Advanced Searches:
- "Find pages created by Sarah"
- "Show me recently updated pages"
- "Search for pages with 'budget' in the title"
- "Find all pages in the Projects database"
Viewing Page Content
Ask aura to show you page details:
Examples:
- "Show me the content of the Q4 Planning page"
- "What's in my Product Roadmap page?"
- "Display the meeting notes from yesterday"
- "Read the content of the Marketing Strategy page"
Creating Pages
Create new Notion pages through aura:
Examples:
- "Create a new page titled 'Weekly Review'"
- "Add a page to my Projects database: New Website Launch"
- "Create a meeting notes page for today's standup"
- "Make a new page in the Marketing workspace about social media strategy"
aura will:
- Understand your intent
- Create the page in the appropriate location
- Add initial content if specified
- Confirm the creation with a link
Updating Pages
Modify existing pages with natural language:
Examples:
- "Add a task to my Todo page: Review Q4 budget"
- "Update the Project Status page with latest progress"
- "Add notes to today's meeting page"
- "Append the action items to the Strategy page"
Working with Databases
Query and manage Notion databases:
Examples:
- "Show me all tasks in my Todo database"
- "Find projects with status 'In Progress'"
- "Create a new task: Review design mockups"
- "Update the status of 'Website Redesign' to Complete"
- "Show me all database entries assigned to me"
Managing Your Integration
Updating Integration Token
To update your Notion integration token:
- Navigate to the Notion integration page in aura
- Click the "Settings" tab
- Get your current token from Notion:
- Go to Notion Integrations
- Find your integration
- Copy the token
- Paste the new token in aura
- Click "Update Notion"
- Verify the status returns to "Connected"
Adding Access to More Pages
To give your integration access to additional pages:
- Open the Notion page you want to add
- Click "•••" menu in the top right
- Click "Add connections"
- Select your "aura Integration"
- Click "Confirm"
- The page is now searchable through aura
Removing Access from Pages
To revoke integration access from specific pages:
- Open the Notion page
- Click "•••" menu in the top right
- Find your integration under "Connections"
- Click the "×" to remove access
- The page will no longer be accessible through aura
Disconnecting the Integration
To remove the Notion integration:
- Go to the Notion integration page in aura
- Click the "Info" tab
- Scroll down and click "Unlink Notion"
- Confirm the disconnection
- You'll be redirected to the Integrations page
Note: Disconnecting will:
- Remove access to Notion data in aura
- Prevent searching Notion pages
- Not affect your Notion workspace or content
- Not delete any pages or data in Notion
Optional: Delete the integration in Notion:
- Go to Notion Integrations
- Find your "aura Integration"
- Click "•••" menu
- Select "Delete integration"
- Confirm deletion
Troubleshooting
Connection Failed
Possible causes:
- Incorrect integration token
- Token doesn't start with
secret_ - Integration was deleted in Notion
- Network connectivity issues
Solutions:
- Verify you copied the complete token (starts with
secret_) - Check that the integration still exists in Notion
- Try creating a new integration and token
- Check your internet connection
- Ensure no firewall is blocking Notion API
Search Not Returning Results
Possible causes:
- Pages not shared with integration
- No pages match search criteria
- Integration lacks read permissions
- Token expired or invalid
Solutions:
- Verify pages are shared with your integration
- Check integration has "Read content" capability
- Try broader search terms
- Confirm integration token is valid
- Share more pages with the integration
Cannot Create or Update Pages
Possible causes:
- Integration lacks write permissions
- Page is not shared with integration
- Insufficient permissions in Notion
- Token invalid
Solutions:
- Enable "Insert content" capability in integration settings
- Enable "Update content" capability for editing
- Share the target page with your integration
- Verify you have edit permissions in Notion
- Update integration token if expired
"Access Denied" Errors
Possible causes:
- Page not shared with integration
- Workspace permissions changed
- Integration removed from page
- Token revoked
Solutions:
- Share the page with your integration again
- Check workspace-level permissions
- Verify integration still exists in Notion
- Regenerate and update token if needed
- Contact workspace admin if needed
Security & Permissions
What aura Can Access
With Notion integration, aura can:
- Read pages explicitly shared with the integration
- Search content in accessible pages
- Create new pages (if capability enabled)
- Update existing pages (if capability enabled)
- Query databases shared with integration
What aura Cannot Access
aura respects Notion permissions and cannot:
- Access pages not shared with the integration
- Read private pages you don't own
- Modify workspace settings
- Access billing information
- Delete pages or databases
- Share pages on your behalf
Data Storage & Privacy
What We Store:
- Integration token (encrypted)
- Connection status and metadata
- User preferences for the integration
What We Don't Store:
- No Notion page content
- No database entries
- No page titles or metadata
- No cached search results
- No copies of your Notion data
Real-Time Access:
- All searches query Notion directly
- Content retrieved on-demand
- No intermediate storage
- No data persistence in aura
Token Security
Your Notion integration token is:
- Encrypted in transit and at rest
- Never exposed in logs or error messages
- Only used to authenticate with Notion API
- Revocable anytime from Notion settings
- Stored securely with industry-standard practices
Best Practices
Integration Setup
- Use descriptive names for your integration
- Only enable capabilities you need
- Share integration with parent pages for easier management
- Regularly review which pages have integration access
- Keep your integration token secure
Page Organization
- Organize pages in a clear hierarchy
- Use consistent naming conventions
- Tag pages for easier searching
- Share relevant pages with the integration
- Remove access from pages you no longer need to search
Search Efficiency
- Use natural, conversational language
- Include relevant context in queries
- Start broad, then narrow down
- Leverage page titles and tags
- Use database properties in searches
Security Hygiene
- Never share your integration token
- Regularly review integration permissions
- Remove integration access from sensitive pages
- Regenerate tokens periodically
- Monitor integration activity in Notion
Advanced Features
Database Queries
Query Notion databases with complex filters:
Examples:
- "Show me tasks due this week with high priority"
- "Find all projects assigned to the marketing team"
- "List completed tasks from last month"
- "Show me database entries created by Sarah"
Cross-Platform Workflows
Connect Notion with other integrations:
Examples:
- "Create a Notion page from this email"
- "Add this Jira issue to my Notion project tracker"
- "Link this Notion page to the calendar event"
- "Create a Todoist task from this Notion page"
Content Generation
Use AI to generate Notion content:
Examples:
- "Create a meeting notes template in Notion"
- "Generate a project plan page with standard sections"
- "Create a weekly review page with prompts"
- "Make a brainstorming page for the new feature"
Bulk Operations
Perform operations across multiple pages:
Examples:
- "Update all project pages with the new timeline"
- "Add a tag to all marketing-related pages"
- "Find and update all pages mentioning the old product name"
Integration Tips
Workspace Organization
For optimal use of the Notion integration:
- Create a Dedicated Space: Consider a "Searchable" section for pages you want in aura
- Use Templates: Create page templates for consistent structure
- Tag Strategically: Use tags to make pages easier to find
- Maintain Hierarchy: Organize pages in a logical structure
Sharing Strategy
For Personal Use:
- Share your integration with your main workspace page
- This gives access to all child pages automatically
- Easier than sharing individual pages
For Team Use:
- Share integration with specific team spaces
- Coordinate with team on which pages to include
- Respect privacy by not sharing personal pages
Performance Optimization
- Keep page titles descriptive for better search
- Use database properties for structured data
- Organize related pages together
- Archive old pages to reduce clutter
Coming Soon
Expanded Capabilities
We're constantly improving the Notion integration:
- Advanced Filters: More granular search controls
- Bulk Operations: Update multiple pages at once
- Template Library: Pre-built page templates
- Relation Support: Better handling of linked databases
- Formula Integration: Work with Notion formulas
- Automation Triggers: Create workflows based on Notion changes
- Collaborative Features: Team-based search and management
Need Help?
- Integrations Overview - General integration information
- Dashboard Guide - Understanding integration status
- FAQ - Common questions
- Troubleshooting - Solutions to common issues
- Notion Help - Official Notion documentation
- Notion API Docs - Notion API reference
Connect your Notion workspace to aura and experience intelligent search across all your knowledge. With zero data storage on our end, your privacy is guaranteed while you enjoy seamless access to your Notion content.