GET/social-media/my-social-accounts

Retrieves a list of social media accounts connected to the workspace associated with the API key.

https://api.postfa.st/Auth: pf-api-keyRate limit: 350 requests per hour

What DISABLED means

When connectionStatus is DISABLED, publishing to that account is paused until it is reconnected (re-authorized) in the PostFast app. Reconnecting resumes future scheduled posts automatically.

Posts already scheduled to an account that becomes disabled are held, not deleted. If the account is reconnected before the scheduled time they publish normally; if the scheduled time passes while the account is still disabled they are marked FAILED and can be retried.

Connection status is tracked per connection, so the same social account connected to multiple workspaces is tracked independently for each.

Response

200 OK Array of connected social media accounts.

idstringrequired

Unique identifier for the account. Account IDs are immutable and safe to cache.

platformstringrequired

Social network the account belongs to, one of the 11 supported platforms: X, FACEBOOK, INSTAGRAM, THREADS, LINKEDIN, TIKTOK, YOUTUBE, BLUESKY, PINTEREST, TELEGRAM, GOOGLE_BUSINESS_PROFILE.

platformUsernamestringoptional

Username on the platform.

displayNamestringoptional

Display name of the account.

connectionStatusstringrequired

CONNECTED means publishing works; DISABLED means publishing is paused until the account is reconnected.

CONNECTEDDISABLED
disabledReasonstringoptional

Why publishing is paused. Present only when connectionStatus is DISABLED. In practice only TOKEN_REVOKED and ACCOUNT_SUSPENDED are currently produced; PERMISSION_REVOKED and MANUAL are reserved.

TOKEN_REVOKEDACCOUNT_SUSPENDEDPERMISSION_REVOKEDMANUAL