Connect account (OAuth)
Starts an OAuth account connection flow by returning an auth_url you open in the browser. Use this for workspace-owned accounts, then list accounts afterward to find the new UniPost account ID. For customer-owned accounts, use Connect Sessions.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Request Body
profile_idOptionalstring
Profile that should own the connected account. Required when the workspace has multiple profiles.
platformstring
OAuth platform key. Facebook Page OAuth is beta/admin-gated; Bluesky uses direct credentials instead.
Valuestwitter | linkedin | instagram | threads | youtube | tiktok | pinterest | facebook
redirect_urlOptionalstring
Optional app URL where the browser should land after OAuth completes. This is not the OAuth callback URL or platform redirect_uri.
Response Body
200
auth_urlstring
Browser URL to open for the OAuth authorization flow.
401
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "FACEBOOK_DISABLED".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
403
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "FACEBOOK_DISABLED".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "FACEBOOK_DISABLED".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Common values include "UNAUTHORIZED", "VALIDATION_ERROR", and "FACEBOOK_DISABLED".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
Callback URLs
redirect_url is your post-OAuth landing page. The platform OAuth callback URL is generated by UniPost and must match the callback registered for the OAuth app being used.