List accounts
Returns connected social accounts in the current workspace. Use it to discover publishable
account_id values.Authorization
AuthorizationBearer <token>In header
Workspace API key.
Query Params
platform?string
Only return accounts for one platform. [available platforms]
Valuestwitter | linkedin | instagram | facebook | threads | youtube | tiktok | bluesky | pinterest
external_user_id?string
Only return accounts for one Connect user.
Response Body
200
data[]array
Connected social accounts in the current workspace.
data[].idstring
Publishable UniPost account ID.
data[].platformstring
Normalized platform name.
Valuestwitter | linkedin | instagram | facebook | threads | youtube | tiktok | bluesky | pinterest
data[].account_namestring | null
Handle or display name.
data[].statusstring
Connection state.
Valuesactive | reconnect_required | disconnected
data[].connection_typestring
Connection origin.
Valuesbyo | managed
data[].connected_atstring
Connection timestamp.
data[].external_user_idstring | null
Your Connect user ID, if present.
meta.totalnumber
Total number of returned accounts.
meta.limitnumber
Applied list size for this response.
request_idstring
Request identifier for debugging and support.
401
error.codestring
Usually "UNAUTHORIZED" or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase compatibility alias such as "unauthorized" or "internal_error".
error.messagestring
Human-readable auth error.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED" or "INTERNAL_ERROR".
error.normalized_codestring
Lowercase compatibility alias such as "unauthorized" or "internal_error".
error.messagestring
Human-readable auth error.
request_idstring
Request identifier for debugging and support.