v52

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

Create a FinancialAccount

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

post/v1/treasury/financial_accounts

Response

Successful response.

active_featuresstring[]

The array of paths to active Features in the Features hash.

countrystring required

Two-letter country code (ISO 3166-1 alpha-2).

createdinteger required

Time at which the object was created. Measured in seconds since the Unix epoch.

idstring required

Unique identifier for the object.

is_defaultboolean

livemodeboolean required

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

metadataobject nullable

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

nicknamestring nullable

The nickname for the FinancialAccount.

object'treasury.financial_account' required

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

pending_featuresstring[]

The array of paths to pending Features in the Features hash.

restricted_featuresstring[]

The array of paths to restricted Features in the Features hash.

status'closed' | 'open' required

Status of this FinancialAccount.

supported_currenciesstring[] required

The currencies the FinancialAccount can hold a balance in. Three-letter ISO currency code, in lowercase.