Start or resume Stripe Connect onboarding

POST

/stripe/connect/accounts

Creates the caller's Stripe Connect account if they do not have one, then returns a fresh onboarding link in either case. Send the creator to onboardingUrl; the link is single-use and short-lived, so call this again rather than caching it.
If the stored account no longer exists at Stripe, a new account is created transparently. Requires a bearer session; rate limited to 100 requests per minute per account.

Authorizations

BearerAuth

In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.

Type

HTTP (bearer)

Request Body

application/json

{

"businessType": "individual"

}

Responses

Account id plus a fresh onboarding link

Content-Type

application/json

{

"accountId": "acct_1AbCdEfGhIjKlMnO",

"onboardingUrl": "string",

"status": "string"

}

POST

/stripe/connect/accounts

Playground

Server

Authorization

BearerAuth

Body

Samples

Powered by VitePress OpenAPI