Get connect session
Returns the current status of a hosted Connect session. Subscribe to the
account.connected webhook for production completion handling; use this endpoint for local development, CLI demos, or fallback polling.Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Params
session_idstring
Connect session ID such as cs_abc123.
Response Body
200
idstring
Connect session ID.
statusstring
Session lifecycle state.
Valuespending | completed | expired | cancelled
managed_account_idstring | null
Resulting UniPost account when the flow completes.
completed_social_account_idstring | null
Alias of managed_account_id for completed sessions.
external_user_idstring
Your user identifier associated with the flow.
expires_atstring
Expiration timestamp for the hosted session. Pending sessions expire after 30 minutes.
401
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
404
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
Polling behavior
Poll only until the session reaches a terminal state: completed, expired, or cancelled. New sessions expire after 30 minutes. For production integrations, prefer developer webhooks.