v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Create a Session

To launch the Financial Connections authorization flow, create a Session. The session’s client_secret can be used to launch the flow using Stripe.js.

post/v1/financial_connections/sessions

Response

Successful response.

client_secretstring nullable

A value that will be passed to the client to launch the authentication flow.

idstring required

Unique identifier for the object.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'financial_connections.session' required

String representing the object's type. Objects of the same type share the same value.

permissionsstring[] required

Permissions requested for accounts collected during this session.

prefetchstring[] nullable

Data features requested to be retrieved upon account creation.

return_urlstring

For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.