Connected Accounts

A connected account represents a single social handle that one of your end users has authorized Synposter to act on their behalf. Connected accounts are the object you target whenever you publish a post, fetch analytics for that handle, or revoke access on the user's behalf.

What is a social account?

A social account is a single handle on a single platform (an X account, a LinkedIn page, a Bluesky handle, and so on) for which an end user has granted Synposter an OAuth token. A single end user often owns several social accounts at once, for example a personal X handle and a company LinkedIn page. In Synposter, all of those accounts attach to the same profile, so you can address any of them through that one user's profile.

Connected accounts can only be created through the OAuth connect flow. There is no direct POST /v1/accounts endpoint because Synposter has to handle the token exchange itself: that's the only way it can keep the credentials safely encrypted and refresh them on your behalf as they expire.

Fields on a connected account

• id — the Synposter UUID for this connected account. Use this whenever you target the account from another endpoint, such as publishing a post or disconnecting it.
• profileId — the parent profile this account is attached to.
• platform — the platform identifier (currently always twitter; more platforms are coming).
• handle — the user's username on the platform. Synposter caches it for display purposes, but the platform itself is the source of truth, so a username change there may take a moment to reflect here.
• status — one of active, expired, or revoked. Synposter refreshes OAuth tokens automatically in the background, so you'll only see expired when the refresh itself fails (typically because the user revoked access from the platform's settings).
• scopes — the OAuth scopes the user granted at connect time, such as tweet.write.

OAuth tokens themselves are encrypted at rest and are never returned through the API, so your application never has to handle them directly.

Endpoints