Skip to content
TeamLoop

Notion Integration

Connect Notion to search pages, databases, and documentation across your workspace.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
PagesDocuments, notes, wiki pages
DatabasesTables, boards, lists
PropertiesMetadata from database items
ContentPage text, headings, lists

Connecting Notion

Section titled “Connecting Notion”
  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to Notion
  4. Enter your Notion Internal Integration API key

Creating a Notion API Key

Section titled “Creating a Notion API Key”
  1. Go to notion.so/my-integrations
  2. Click New integration
  3. Give it a name (e.g., “TeamLoop”)
  4. Select your workspace
  5. Under Capabilities, ensure Read content is enabled
  6. Copy the Internal Integration Secret
  7. In Notion, share the pages/databases you want TeamLoop to access with your integration

We never modify your Notion workspace.

Example Queries

Section titled “Example Queries”

Search Documentation

Section titled “Search Documentation”
teamloop_query:
  query: "API design guidelines"
  sources: "notion"

Find Meeting Notes

Section titled “Find Meeting Notes”
teamloop_query:
  query: "engineering sync meeting notes Q4"
  sources: "notion"

Search PRDs

Section titled “Search PRDs”
teamloop_query:
  query: "product requirements user authentication"
  sources: "notion"

Entity Extraction

Section titled “Entity Extraction”

Notion content maps to TeamLoop entity types:

Notion ContentTeamLoop Entity
PageDOCUMENT
Database itemDOCUMENT
Decision docDECISION
Person mentionPERSON
Project pagePROJECT

Temporal Queries with Notion

Section titled “Temporal Queries with Notion”

Point-in-Time

Section titled “Point-in-Time”

What was documented on a specific date:

teamloop_query:
  query: "authentication design"
  sources: "notion"
  mode: "as_of"
  as_of: "2024-06-01"

Track Documentation Evolution

Section titled “Track Documentation Evolution”
teamloop_evolution:
  query: "product roadmap"
  from_date: "2024-01-01"
  to_date: "2024-12-31"

Best Practices

Section titled “Best Practices”

1. Organize Notion for Discoverability

Section titled “1. Organize Notion for Discoverability”

Structure helps TeamLoop find relevant content.

2. Use Database Properties

Section titled “2. Use Database Properties”

Notion databases with rich properties (Status, Owner, Date, Tags) work well.

3. Include Context in Pages

Section titled “3. Include Context in Pages”

TeamLoop extracts better entities from well-documented pages with clear sections.

4. Link Related Content

Section titled “4. Link Related Content”

Notion links become relationships in TeamLoop.

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Verify pages are shared with your Notion integration (in Notion, click ”…” on the page > “Connections” > add your integration)
  • Check your API key is valid at notion.so/my-integrations
  • Ensure pages aren’t in private sections
  • Try broader search terms

Missing Pages

Section titled “Missing Pages”

Pages must be explicitly shared with your Notion integration. Parent page sharing cascades to child pages.

Security

Section titled “Security”
  • API tokens are encrypted at rest using pgcrypto
  • Only accesses content you explicitly share with the integration
  • You can revoke the key at notion.so/my-integrations
  • TeamLoop never writes to Notion

Next Steps

Section titled “Next Steps”