Connector Troubleshooting

​

Quick Health Check

const connections = await client.connections.list({
  containerTags: ['user-123']
});

connections.forEach(conn => {
  console.log(`${conn.provider}: ${conn.email} - Connected ${conn.createdAt}`);
});

// Check for stuck documents
const documents = await client.connections.listDocuments('notion', {
  containerTags: ['user-123']
});

const failed = documents.filter(doc => doc.status === 'failed');
if (failed.length > 0) {
  console.log(`⚠️ ${failed.length} documents failed to sync`);
}

connections = client.connections.list(container_tags=['user-123'])

for conn in connections:
    print(f"{conn.provider}: {conn.email} - Connected {conn.created_at}")

# Check for stuck documents
documents = client.connections.list_documents(
    'notion',
    container_tags=['user-123']
)

failed = [doc for doc in documents if doc.status == 'failed']
if failed:
    print(f"⚠️ {len(failed)} documents failed to sync")

# List all connections
curl -X POST "https://api.supermemory.ai/v3/connections/list" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerTags": ["user-123"]}'

# Check document status
curl -X POST "https://api.supermemory.ai/v3/documents/list" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerTags": ["user-123"], "source": "notion"}'

​

Common Issues

​

OAuth Callback Fails

// correct - exact match with OAuth app settings
const connection = await client.connections.create('notion', {
  redirectUrl: 'https://yourapp.com/auth/notion/callback',
  containerTags: ['user-123']
});

// Wrong - URL doesn't match
// redirectUrl: 'https://yourapp.com/callback'

• Use HTTPS for production URLs
• Copy the exact URL from your OAuth app settings
• Test the flow in development first

​

Documents Not Syncing

// Force sync for stuck documents
await client.connections.import('notion', {
  containerTags: ['user-123']
});

• 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

// Delete and recreate connection
await client.connections.deleteByProvider('google-drive', {
  containerTags: ['user-123']
});

const newConnection = await client.connections.create('google-drive', {
  redirectUrl: 'https://yourapp.com/callback',
  containerTags: ['user-123']
});

// User must re-authenticate
window.location.href = newConnection.authLink;

​

Sync Takes Too Long

const connection = await client.connections.create('onedrive', {
  redirectUrl: 'https://yourapp.com/callback',
  containerTags: ['user-123'],
  documentLimit: 500  // Start with fewer documents
});

​

Provider-Specific Issues

​

Google Drive

• User has access to the shared drive
• OAuth app has drive.readonly scope
• User is a member of the shared drive

​

Notion

1. Go to Notion workspace settings
2. Find your integration under “Connections”
3. Click on the integration
4. Select specific pages/databases to share
5. Re-sync after granting access

1. Approve the integration
2. Grant access to all pages
3. Enable “Read content” permission

​

OneDrive

• Admin consent might be required
• Some SharePoint sites may be restricted
• Compliance policies may block certain files

​

Gmail

1. Real-time sync uses Google Cloud Pub/Sub webhooks
2. Watch subscriptions expire after 7 days (supermemory auto-renews)
3. Only INBOX label triggers real-time updates
4. Trigger a manual sync to verify the connection is healthy:

await client.connections.import('gmail', {
  containerTags: ['user-123']
});

1. The user may have revoked app access in Google Account settings
2. Delete and recreate the connection
3. Ensure user completes full OAuth consent flow

// Re-authenticate to get fresh tokens
await client.connections.deleteByProvider('gmail', {
  containerTags: ['user-123']
});

const newConnection = await client.connections.create('gmail', {
  redirectUrl: 'https://yourapp.com/callback',
  containerTags: ['user-123']
});

• Verify your organization has the required plan
• Contact support to upgrade your plan

​

Best Practices

1. Set reasonable document limits - Start with 500-1000 documents
2. Use descriptive container tags - Makes debugging easier
3. Monitor failed documents - Check weekly for sync issues
4. Handle rate limits gracefully - Implement exponential backoff
5. Test OAuth in development - Ensure redirect URLs work before production