GET
/v1/social-accountsList all connected social media accounts in the current workspace. Returns active accounts by default; disconnected accounts are excluded unless queried by ID.
Requires AuthRate Limited
Overview
After connecting social accounts (either via the dashboard or the Connect flow), this endpoint returns them with their platform, status, and the id you need for publishing.
Filter by platform to list only Instagram accounts, or by external_user_id to find accounts onboarded by a specific end user via Connect.
Authentication
Authorization: Bearer up_live_xxxxRequest
GET https://api.unipost.dev/v1/social-accounts
Query Parameters
Examples
const response = await fetch(
'https://api.unipost.dev/v1/social-accounts',
{
headers: {
'Authorization': 'Bearer up_live_xxxx',
},
}
);
const { data } = await response.json();
for (const account of data) {
console.log(account.id, account.platform, account.status);
}Response
{
"data": [
{
"id": "sa_instagram_123",
"platform": "instagram",
"account_name": "magicxiaobo416",
"account_avatar_url": "https://...",
"status": "active",
"connection_type": "byo",
"connected_at": "2026-04-02T10:00:00Z",
"external_user_id": null
},
{
"id": "sa_linkedin_456",
"platform": "linkedin",
"account_name": "Xiaobo Yu",
"account_avatar_url": "https://...",
"status": "active",
"connection_type": "managed",
"connected_at": "2026-04-05T14:30:00Z",
"external_user_id": "user_abc"
}
]
}Response fields
connection_type explained
byo = White-label (your own platform credentials, OAuth shows your app name).managed= Connected via UniPost Connect flow (end-user OAuth through UniPost's hosted page).