Skip to main content

List connected social profiles

GET 
/api/v1/partner-gateway/socials

Returns all social media profiles currently connected to your account. A social profile represents an authenticated connection to an external platform such as Facebook, Instagram, LinkedIn, Google, or TikTok. Profiles are established through the platform's OAuth flow in the web dashboard and cannot be connected via this API. Each entry in the response includes the platform name, username, profile name, profile picture URL, connection date, a disconnected flag indicating whether the connection has become invalid, and a count of linked pages or sub-accounts. To get full details for a specific platform, including all linked pages and sub-accounts, call GET /socials/{platform} with the platform name (e.g. facebook, instagram, linkedin, google, tiktok). If a profile shows disconnected=true, the OAuth token has expired or been revoked and the connection must be re-established through the web dashboard. Returns 401 if the API key is missing or invalid. Returns 502 if the upstream profile service is temporarily unavailable.

Responses​

Social profiles retrieved successfully

Last updated on