Mobile Integrations
Mobile integrations let the Social Archiver mobile app send completed archives to external knowledge and read-it-later tools. These integrations are configured from the mobile app, not from the Obsidian plugin.
Current mobile app integrations include Notion, Reader, and Karakeep.
Overview
| Integration | Status | Best for | Connect with |
|---|---|---|---|
| Notion | Available | Building a Notion database of archived posts and pages | Notion OAuth from the mobile app |
| Reader | Available when shown in your mobile app | Sending archives to Readwise Reader | Readwise access token |
| Karakeep | Beta, available when shown in your mobile app | Saving archives to a self-hosted bookmark manager | Karakeep server URL and API key |
Reader means Readwise Reader in the mobile app. If Reader or Karakeep does not appear in your settings, update the mobile app first. Some integrations can also depend on rollout or build availability.
Before You Connect
- Install and sign in to the Social Archiver mobile app.
- Open Settings -> Integrations.
- Keep Auto-sync enabled if you want completed archives to sync to Notion and other connected clients automatically.
- Use each integration's Auto-save setting for Reader and Karakeep.
- Turn on WiFi only if you want client sync to wait for WiFi.
Each integration uses your Social Archiver account, but the external service still needs its own authorization, token, or API key.
Notion
The Notion integration syncs completed archives from the mobile app to a Notion workspace. Social Archiver can create or reuse a Social Archives database, then write each archive as a Notion page.
What It Sends
- Archive title, platform, original URL, archive ID, and archived date
- Available metadata such as author, handle, published date, likes, comments, shares, and views
- Archive content blocks and available media references
- Video upgrade processing where supported by the backend and Notion file limits
Connect Notion
- Open the mobile app.
- Go to Settings -> Integrations.
- Tap Connect on the Notion row.
- Authorize Social Archiver in the Notion browser flow.
- Grant access to the workspace or page where the database can be created.
- Return to Social Archiver after authorization completes.
After connection, the Notion row shows the connected workspace. New completed archives can sync automatically when Auto-sync is enabled.
Disconnect Notion
Tap the connected Notion row in Settings -> Integrations, then confirm disconnect. Syncing to that workspace stops, but existing Notion pages are not deleted.
Reader
The Reader integration saves completed archives to Readwise Reader. It is useful when you want Social Archiver captures to enter the same reading queue as articles, newsletters, and saved web pages.
What It Sends
- Original URL and archive title
- Author, summary, content or HTML, image URL, and notes when available
- Tags, including your default tags and optional platform tag
- Reader category based on the source, such as article, social post, or video
Connect Reader
- Open readwise.io/access_token and copy your access token.
- Open the Social Archiver mobile app.
- Go to Settings -> Integrations.
- Tap Connect on the Reader row.
- Paste the token and connect.
Reader Settings
Tap the connected Reader row to configure:
- Auto-save: save to Reader when archives complete
- Save Location: send items to Later or New
- Default Tags: tags added to Reader saves
- Include platform tag: add tags such as the source platform name
- Platforms: choose which mobile archive sources are allowed to save to Reader
You can also use Save to Readwise from an archive action menu when the archive has an original URL and the platform is allowed.
Disconnecting Reader removes the saved token from the mobile app. Existing Reader items are not deleted.
Karakeep
The Karakeep integration saves completed archives as bookmarks in a Karakeep server. It is useful if you run a self-hosted read-it-later or bookmark workflow.
What It Sends
- Original URL and archive title
- Summary or note content when available
- Default tags and optional platform tag
- Archive metadata that can be represented in a Karakeep bookmark
Connect Karakeep
- In Karakeep, create an API key from Settings -> API Keys.
- Open the Social Archiver mobile app.
- Go to Settings -> Integrations.
- Tap Connect on the Karakeep row.
- Enter your Karakeep server address, such as
https://bookmarks.example.com. - Paste the API key and connect.
The mobile app accepts a base server URL and normalizes it for the Karakeep API. You do not need to add /api/v1.
Karakeep Settings
Tap the connected Karakeep row to configure:
- Auto-save: save to Karakeep when archives complete
- Default Tags: tags added to Karakeep bookmarks
- Include platform tag: add tags such as the source platform name
- Platforms: choose which mobile archive sources are allowed to save to Karakeep
You can also use Save to Karakeep from an archive action menu when the archive has an original URL and the platform is allowed.
Disconnecting Karakeep removes the saved credentials from the mobile app. Existing Karakeep bookmarks are not deleted.
Auto-save and Manual Save
Auto-save runs after an archive completes. Manual save actions are available from archive action menus for Reader and Karakeep when:
- The integration is connected and enabled
- The archive has an original URL
- The archive platform is not excluded in that integration's settings
- The mobile device is online
Reader and Karakeep can report that an item already exists. In that case, the mobile app shows an "Already in Reader" or "Already in Karakeep" message instead of creating a duplicate.
Troubleshooting
| Problem | What to check |
|---|---|
| Integration row is missing | Update the mobile app. Reader and Karakeep may only appear in supported builds or rollout groups. |
| Notion connect fails | Confirm the browser authorization completed and that Social Archiver has access to at least one Notion page where a database can be created. |
| Reader token fails | Generate a fresh token from readwise.io/access_token, then paste it again. |
| Karakeep connect fails | Check the server URL, API key, HTTPS access, and whether the Karakeep server is reachable from your phone. |
| Notion sync did not run | Confirm Auto-sync is enabled and the Notion connection is active. |
| Reader or Karakeep auto-save did not run | Confirm that integration's Auto-save setting is enabled, the platform is allowed, the archive has an original URL, and the phone is online. |
| Sync waits too long | Check whether WiFi-only sync is enabled and whether the phone is currently on WiFi. |