supermemory/apps/docs/memory-api/connectors/overview.mdx
2025-11-24 17:12:25 -08:00

34 lines
1.4 KiB
Text

---
title: 'Connectors Overview'
sidebarTitle: 'Overview'
description: 'Sync external connections like Google Drive, Notion, OneDrive, Web Crawler with supermemory'
---
supermemory can sync external connections like Google Drive, Notion, OneDrive, and Web Crawler.
### The Flow
For OAuth-based connectors (Notion, Google Drive, OneDrive):
1. Make a `POST` request to `/v3/connections/{provider}`
2. supermemory will return an `authLink` which you can redirect the user to
3. The user will be redirected to the provider's login page
4. User is redirected back to your app's `redirectUrl`
For Web Crawler:
1. Make a `POST` request to `/v3/connections/web-crawler` with `startUrl` in metadata
2. Connection is established immediately (no OAuth required)
3. Crawling begins automatically
![Connectors Flow](/images/connectors-flow.png)
## Sync frequency
supermemory syncs documents:
- **A document is modified or created (Webhook received)**
- Note that not all providers are synced via webhook (Instant sync right now)
- `Google-Drive` and `Notion` documents are synced instantaneously
- `Web-Crawler` uses scheduled recrawling instead of webhooks
- Every **four hours** (for OAuth-based connectors)
- **Scheduled recrawling** (for Web Crawler - sites recrawled if not synced in 7+ days)
- On **Manual Sync** (API call)
- You can call `/v3/connections/{provider}/sync` to sync documents manually