Get a connect session
Poll a session’s status. connected_organization_id appears once the company completes the flow. The one-time code itself is never returned here — it only rides the redirect.
Authorizations
A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.
Path Parameters
Response
The session.
Session id (pcs_…). Use it to poll status and exchange the code.
"platform_connect_session"
pending → the company hasn't finished the hosted flow. bound → the company picked an organization but hasn't confirmed yet. completed → the code was issued and is ready to exchange. claimed → you already exchanged it. expired → the link lapsed.
pending, bound, completed, claimed, expired Your opaque passthrough value, echoed on the final redirect.
Deprecated spelling of test_mode.
Inherited from the credential that created the session.
The connected organization, present once the company completes the flow.
The hosted link expires 60 minutes after creation.