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 does not show it
Solution: A pending OAuth connector is not returned by list until the user finishes authorization. connectors.get still returns it with system.status: "pending_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: The provider always redirects to Supermemory’s callback, not to yourredirectUrl. If you use a custom OAuth application, its redirect URI must be exactly https://api.supermemory.ai/v3/connections/auth/callback/{provider}. Your redirectUrl is where Supermemory sends the user after it handles that callback, and must be an http or https URL:
- Use HTTPS for production URLs
- Register
https://api.supermemory.ai/v3/connections/auth/callback/{provider}in your custom 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 manual sync works:- Real-time sync uses Google Cloud Pub/Sub webhooks
- Watch subscriptions expire after 7 days (supermemory auto-renews)
- Real-time updates cover only the labels selected for the connector
- 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
- Upgrade from Billing in the console
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