Quick health check
Check if your connectors are working properly:There is no per-connector document list in v5.
supermemory.list(namespace, "documents") returns every document in the namespace; read each document’s system.status.Common issues
Connector Missing From List
Problem:connectors.create returned an id, but connectors.list and connectors.get do not show it
Solution: A pending OAuth connector is not visible in list or get until the user finishes authorization. Send the user to authorization.url before authorization.expiresAt. If the link expired, create the connector again.
OAuth callback fails
Problem: “Invalid redirect URI” error after user grants permissions Solution: Ensure your redirect URL matches EXACTLY what’s configured in your OAuth app:- Use HTTPS for production URLs
- Copy the exact URL from your OAuth app settings
- Test the flow in development first
Documents not syncing
Problem: Documents stuck in “queued” or “extracting” status for over 30 minutes Solution: Trigger a manual sync:- Read
latestRun.errorandinclude: "syncs"for the failed items - Check if files are over 50MB (may timeout)
- Verify you have permission to access the documents
- Ensure the document type is supported
Permission denied errors
Problem: Some documents show “permission denied” or aren’t syncing Solution: Re-authenticate with proper permissions:Sync takes too long
Problem: Hundreds of documents taking hours to sync Solution: Set reasonable document limits:Provider-specific issues
Google Drive
Shared Drive Issues Shared drives require special permissions. Make sure:- User has access to the shared drive
- OAuth app has drive.readonly scope
- User is a member of the shared drive
include: "picker" and send the user to picker.url.
Notion
Database Not Syncing Notion databases need explicit permission. If databases aren’t syncing:- Go to Notion workspace settings
- Find your integration under “Connections”
- Click on the integration
- Select specific pages/databases to share
- Re-sync after granting access
- Approve the integration
- Grant access to all pages
- Enable “Read content” permission
OneDrive
Business vs Personal Accounts Business accounts may have additional restrictions:- Admin consent might be required
- Some SharePoint sites may be restricted
- Compliance policies may block certain files
Gmail
Real-time Sync Not Working If emails aren’t syncing in real-time but scheduled/manual sync works:- Real-time sync uses Google Cloud Pub/Sub webhooks
- Watch subscriptions expire after 7 days (supermemory auto-renews)
- Only INBOX label triggers real-time updates
- Trigger a manual sync to verify the connector is healthy:
- The user may have revoked app access in Google Account settings
- Delete and recreate the connector
- Ensure user completes full OAuth consent flow
- Verify your organization has the required plan
- Contact support to upgrade your plan
Best practices
- Set reasonable document limits - Start with 500-1000 documents
- Use one namespace per user or tenant - Makes debugging easier
- Monitor
latestRun- Check weekly for failed syncs - Handle rate limits gracefully - Implement exponential backoff
- Test OAuth in development - Ensure redirect URLs work before production