Sample - Stripe API
POST/v1/treasury/financial_accounts

Create a FinancialAccount

Creates a new FinancialAccount. Each connected account can have up to three FinancialAccounts by default.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

6 body fields
expandarray<string>optional
Specifies which fields in the response should be expanded.
featuresobjectoptional
Encodes whether a FinancialAccount has access to a particular feature. Stripe or the platform can control features via the requested field.
metadataobjectoptional
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
nicknamestringoptional
The nickname for the FinancialAccount.
platform_restrictionsobjectoptional
The set of functionalities that the platform can restrict on the FinancialAccount.
supported_currenciesarray<string>required
The currencies the FinancialAccount can hold a balance in.

2 status codes
200Successful response.
active_featuresarray<string>optional
The array of paths to active Features in the Features hash.
balanceobjectrequired
Balance information for the FinancialAccount
countrystringrequired
Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
featuresobjectoptional
Encodes whether a FinancialAccount has access to a particular Feature, with a `status` enum and associated `status_details`. Stripe or the platform can control Features via the requested field.
financial_addressesarray<TreasuryFinancialAccountsResourceFinancialAddress>required
The set of credentials that resolve to a FinancialAccount.
idstringrequired
Unique identifier for the object.
is_defaultbooleanoptional
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
metadataobjectoptional
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
nicknamestringoptional
The nickname for the FinancialAccount.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:treasury.financial_account
pending_featuresarray<string>optional
The array of paths to pending Features in the Features hash.
platform_restrictionsobjectoptional
The set of functionalities that the platform can restrict on the FinancialAccount.
restricted_featuresarray<string>optional
The array of paths to restricted Features in the Features hash.
statusstringrequired
Status of this FinancialAccount.
Allowed:closedopen
status_detailsobjectrequired
supported_currenciesarray<string>required
The currencies the FinancialAccount can hold a balance in. Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
defaultError response.
errorobjectrequired

Error handling

Any other status is an error: Error response.