Skip to content
Browse the docs

DocsUse it

Connecting accounts

Connecting Mastodon, Bluesky, LinkedIn, Threads and X, reconnecting when a token expires, and what disconnecting keeps.

On this page
The Connected Accounts page: X, Threads, LinkedIn, Mastodon and Bluesky, each with a green Connected badge, and a Connect new button above the list.
Connected Accounts is where a finished OAuth app shows up. Mastodon and Bluesky connect without one.

Accounts lists every connected account and how to add another. Connect new opens the platform picker.

Mastodon and Bluesky

These two connect with what you already have:

  • Mastodon — enter your instance’s address and approve CogSend on your instance. The app registers itself there; there is nothing to create first.
  • Bluesky — enter your handle and an app password, which you create in Bluesky under Settings → Privacy and security → App passwords. Never use your main password.

LinkedIn, Threads and X

These three need a developer app of your own before they can connect, because the platform issues the client id and secret the Worker uses. Until one is set up, the picker shows the platform with a Needs setup badge, and choosing it shows that platform’s steps — the redirect URI to register and the Worker secrets to set — instead of a connect attempt that cannot succeed. The full steps are in OAuth apps.

Once the secrets are on the Worker, reload the page and connect as usual.

When an account needs reconnecting

A token that stops working marks the account as needing a reconnect, both here and in the composer’s account list; Reconnect starts the same flow again and keeps the account’s history. The usual cause is LinkedIn: a self-created LinkedIn app gets a 60-day token and nothing to renew it with, so it has to be reconnected every 60 days (why).

Disconnecting

Disconnecting an account removes its scheduled posts, returns drafts that were still waiting, and keeps what it already published — the confirmation says how many of each. A disconnected account’s history stays in Insights, marked Archived.

Where to go next

Written for CogSend 1.3.2. This page lives in the app repo, next to the code it describes. Something wrong or missing? Edit docs/accounts.md or open an issue.