X Bookmarks Integration

Arivu can import bookmarks from X when an administrator enables the optional OAuth integration. Imported links enter the same Library and background processing pipeline as other captures.

Prerequisites

• An X developer application with OAuth 2.0 enabled
• Confidential client credentials
• A public HTTPS APP_URL

Configure the callback as:

https://your-domain.example/settings?section=connections

Request the scopes bookmark.read, tweet.read, users.read, and offline.access.

Configure Arivu

Prefer Admin settings for routine runtime configuration. The environment fallback is:

X_INTEGRATION_ENABLED=true
X_CLIENT_ID=your_x_client_id
X_CLIENT_SECRET=your_x_client_secret
APP_URL=https://your-domain.example

Set X_REDIRECT_URI only when you need to override the callback derived from APP_URL.

Connect and Sync

1. Open Settings -> Connections.
2. Choose Connect X and complete consent.
3. Confirm the connected account appears.
4. Choose Sync Bookmarks.
5. Find imported items in Library.

Arivu deduplicates imported items with X metadata and normalized URLs. Provider tokens stored through runtime settings are encrypted in SQLite.

X text supplied by X is the authoritative evidence for the post. A linked article is separate source evidence and is used only when its content can be extracted successfully. Metadata alone and failed extraction do not support generated claims. Sync X before reprocessing so repair starts from the latest authoritative X evidence.

Troubleshooting

• If integration is disabled, verify the runtime setting or X_INTEGRATION_ENABLED fallback.
• If the callback fails, compare the exact redirect URI, public URL, and client credentials.
• If sync returns nothing, confirm there are new bookmarks and that X API access or rate limits allow the request.

X API availability, access tiers, and policies are controlled by X and can change independently of Arivu.