Notion Connector

Stop switching between tabs to find information in Notion. Connect your workspace to SourceSync and instantly search across all your Notion pages with AI-powered understanding.

The Problem with Traditional Notion Search

How It Works

Implementation Guide

1. Create Notion Integration

First, create a public integration in Notion:

1. Go to Notion Integrations
2. Click New integration and fill in the basic information:
   • Add integration name as SourceSync Integration (or your preferred name)
   • Select the workspace to install the integration
   • Choose the type of integration as Public
3. Configure OAuth settings:
   • Add redirect URI: https://api.sourcesync.ai/connectors/notion/callback and Save
4. Choose the capabilities:
   • Only enable Read content in Content Capabilities (we don't need write access)
   • No need to select any Comment Capabilities
   • Select No user information in User Capabilities (we don't need to know which user is accessing the integration)
   • Save the configuration
5. Note down your integration's credentials:
   • Client ID
   • Client Secret
   • Authorization URL

2. Configure SourceSync

Add your Notion configuration to your SourceSync namespace: (docs)

curl -X PATCH https://api.sourcesync.ai/v1/namespaces/ns_123 \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "notionConfig": {
      "clientId": "your-notion-client-id",
      "clientSecret": "your-notion-client-secret",
      "authorizationUrl": "your-notion-auth-url"
    }
  }'

3. Create Notion Connection

Now create a connection to your Notion workspace:

1. First, create a new Notion connection (docs), you will get an authorizationUrl in the response
2. Then, open the authorizationUrl in the browser for the user to authorize and select the pages to share with SourceSync
3. After authorization, Notion redirects back to SourceSync
4. Finally, check the status of this connection (docs)
5. If the connection is successful, the status will be ACTIVE and if it's not, the status will be PENDING

# Create Notion connection
curl -X POST https://api.sourcesync.ai/v1/connections \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "namespaceId": "ns_123",
    "name": "My Notion",
    "connector": "NOTION",
    "clientRedirectUrl": "https://example.com/ragaas/notion/success"
  }'

# Open authorizationUrl in browser for user to authorize
# User selects pages using Notion workspace picker
# Notion redirects back to SourceSync after selection

# Check connection status
curl -X GET https://api.sourcesync.ai/v1/connections/conn_abc123?namespaceId=ns_123 \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}"

4. Ingest Notion Content

After successfully creating a connection, you can ingest the selected Notion pages: (docs)

# Start ingestion
curl -X POST https://api.sourcesync.ai/v1/ingest/notion \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "namespaceId": "ns_123",
    "ingestConfig": {
      "source": "NOTION",
      "config": {
        "connectionId": "your-connection-id",
        "metadata": {
          "source": "notion",
          "workspace": "My Workspace"
        }
      }
    }
  }'

# Get the ingestJobRunId from the response

# Check ingestion status
curl "https://api.sourcesync.ai/v1/ingest-job-runs/job_xyz789?namespaceId=ns_123" \
 -H "Authorization: Bearer ${RAGAAS_API_KEY}"

5. Search Your Content

Once your ingestion job is complete, you can search across your Notion pages: (docs)

curl -X POST https://api.sourcesync.ai/v1/search \
  -H "Authorization: Bearer ${RAGAAS_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What is our refund policy?",
    "namespaceId": "ns_123",
    "filter": {
      "metadata": {
        "source": "notion"
      }
    }
  }'

Best Practices

Security & Permissions

1. Minimal Access

   • Our integration only requests read access
   • Users explicitly select which pages to share
   • No write permissions required

2. Data Privacy

   • Content stored in your infrastructure
   • No data retention by SourceSync
   • Your API keys, your control

Content Organization

1. Page Selection

   • Start with a focused set of pages
   • Group related content together
   • Use consistent page structures

2. Metadata

   • Add source and workspace metadata
   • Tag content by department/team
   • Enable filtered searching

Next Steps

1. Start Small

   • Connect a few key pages
   • Test search functionality
   • Gather user feedback

2. Optimize

   • Add more pages gradually
   • Fine-tune search filters
   • Set up regular sync

3. Scale

   • Connect multiple workspaces
   • Build custom search interfaces
   • Integrate with internal tools