Connect account with credentials
Directly connects one social account by sending adapter-specific credentials such as an identifier and password. Use this for non-OAuth flows like Bluesky. When the workspace has multiple profiles, pass profile_id explicitly instead of relying on an implicit default.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Request Body
profile_id?string
Profile that should own the connected account. Required when the workspace has multiple profiles.
platformstring
Direct credential connection currently supports Bluesky. Use OAuth connect for Twitter/X, LinkedIn, Instagram, Threads, TikTok, YouTube, Pinterest, and Facebook.
Valuesbluesky
credentialsobject
Adapter-specific credentials payload used for direct account connection. For Bluesky, send handle and app_password.
Response Body
201
idstring
Connected UniPost account ID.
profile_idstring
Profile the account was attached to.
platformstring
Normalized platform name.
account_namestring | null
Resolved username or display name.
statusstring
Connection state such as "active".
connection_typestring
"byo" or "managed".
connected_atstring
Connection timestamp.
401
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "ACCOUNT_ALREADY_CONNECTED".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "account_already_connected".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
409
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "ACCOUNT_ALREADY_CONNECTED".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "account_already_connected".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "ACCOUNT_ALREADY_CONNECTED".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "account_already_connected".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "ACCOUNT_ALREADY_CONNECTED".
error.normalized_codestring
Lowercase alias such as "unauthorized", "validation_error", or "account_already_connected".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.