POpost-bridge
Social Accounts

Get social account by ID

Changed on

Returns one connected social account: platform, username and whether its authorisation is still valid. An account whose token has expired must be reconnected in the dashboard before it can publish.

get/v1/social-accounts/{id}

Request

  • Base URL
    https://api.post-bridge.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

idnumber required

Social Account ID

Response

Social account retrieved successfully.

idnumber required

The unique identifier of the social account

platformstring required

The platform of the social account

usernamestring required

The platform's username of the social account

profile_picture_urlobject nullable required

The account's profile picture URL, or null when the platform didn't provide one. Updated when the account is reconnected or refreshed.

needs_reconnectboolean required

True when repeated dead-token failures have paused posting to this account (Meta platforms). Posts to it are skipped until the account is reconnected in the dashboard; any reconnect clears it automatically. Pause your automation for accounts in this state instead of retrying.

external_refobject nullable required

Your reference from the connect link that connected this account (POST /social-accounts/connect-link), or null for accounts connected in the dashboard.

connected_via_link_atobject nullable required

When this account was last connected or reconnected through a connect link (ISO 8601), or null if it never was.

has_x_premiumobject nullable required

X (Twitter) accounts only: true when the account is on X Premium, which allows posts up to 25,000 characters instead of 280. Refreshed when the user reconnects or clicks Refresh on X. null for every other platform.

supports_instagram_musicobject nullable required

Instagram accounts only: true when the account is connected through Facebook login, which is the only connection Meta lets attach Instagram music (platform_configurations.instagram.audio_id, tracks from GET /v1/social-accounts/{id}/instagram-audio). false for accounts connected with Instagram login. null for every other platform.

Changes