--- title: "Create a FinancialAccount" method: POST path: "/v1/treasury/financial_accounts" --- # Create a FinancialAccount `POST /v1/treasury/financial_accounts` Creates a new FinancialAccount. Each connected account can have up to three FinancialAccounts by default. ## Response `200` Successful response. - TreasuryFinancialAccount — Stripe Treasury provides users with a container for money called a FinancialAccount that is separate from their Payments balance. FinancialAccounts serve as the source and destination of Treasury’s money movement APIs. - `active_features` string[] — The array of paths to active Features in the Features hash. - `balance` TreasuryFinancialAccountsResourceBalance, required — Balance information for the FinancialAccount - `cash` object, required — Funds the user can spend right now. - `inbound_pending` object, required — Funds not spendable yet, but will become available at a later time. - `outbound_pending` object, required — Funds in the account, but not spendable because they are being held for pending outbound flows. - `country` string, required — Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)). - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch. - `features` TreasuryFinancialAccountFeatures — 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. - `card_issuing` TreasuryFinancialAccountsResourceToggleSettings — Toggle settings for enabling/disabling a feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `deposit_insurance` TreasuryFinancialAccountsResourceToggleSettings — Toggle settings for enabling/disabling a feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `financial_addresses` TreasuryFinancialAccountsResourceFinancialAddressesFeatures — Settings related to Financial Addresses features on a Financial Account - `aba` TreasuryFinancialAccountsResourceAbaToggleSettings — Toggle settings for enabling/disabling the ABA address feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `inbound_transfers` TreasuryFinancialAccountsResourceInboundTransfers — InboundTransfers contains inbound transfers features for a FinancialAccount. - `ach` TreasuryFinancialAccountsResourceInboundAchToggleSettings — Toggle settings for enabling/disabling an inbound ACH specific feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `intra_stripe_flows` TreasuryFinancialAccountsResourceToggleSettings — Toggle settings for enabling/disabling a feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `object` 'treasury.financial_account_features', required — String representing the object's type. Objects of the same type share the same value. - `outbound_payments` TreasuryFinancialAccountsResourceOutboundPayments — Settings related to Outbound Payments features on a Financial Account - `ach` TreasuryFinancialAccountsResourceOutboundAchToggleSettings — Toggle settings for enabling/disabling an outbound ACH specific feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `us_domestic_wire` TreasuryFinancialAccountsResourceToggleSettings — Toggle settings for enabling/disabling a feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `outbound_transfers` TreasuryFinancialAccountsResourceOutboundTransfers — OutboundTransfers contains outbound transfers features for a FinancialAccount. - `ach` TreasuryFinancialAccountsResourceOutboundAchToggleSettings — Toggle settings for enabling/disabling an outbound ACH specific feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `us_domestic_wire` TreasuryFinancialAccountsResourceToggleSettings — Toggle settings for enabling/disabling a feature - `requested` boolean, required — Whether the FinancialAccount should have the Feature. - `status` 'active' | 'pending' | 'restricted', required — Whether the Feature is operational. - `status_details` TreasuryFinancialAccountsResourceTogglesSettingStatusDetails[], required — Additional details; includes at least one entry when the status is not `active`. - `code` 'activating' | 'capability_not_requested' | 'financial_account_closed' | 'rejected_other' | 'rejected_unsupported_business' | 'requirements_past_due' | 'requirements_pending_verification' | 'restricted_by_platform' | 'restricted_other', required — Represents the reason why the status is `pending` or `restricted`. - `resolution` 'contact_stripe' | 'provide_information' | 'remove_restriction', nullable — Represents what the user should do, if anything, to activate the Feature. - `restriction` 'inbound_flows' | 'outbound_flows' — The `platform_restrictions` that are restricting this Feature. - `financial_addresses` TreasuryFinancialAccountsResourceFinancialAddress[], required — The set of credentials that resolve to a FinancialAccount. - `aba` TreasuryFinancialAccountsResourceAbaRecord — ABA Records contain U.S. bank account details per the ABA format. - `account_holder_name` string, required — The name of the person or business that owns the bank account. - `account_number` string, nullable — The account number. - `account_number_last4` string, required — The last four characters of the account number. - `bank_name` string, required — Name of the bank. - `routing_number` string, required — Routing number for the account. - `supported_networks` string[] — The list of networks that the address supports - `type` 'aba', required — The type of financial address - `id` string, required — Unique identifier for the object. - `is_default` boolean - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`. - `metadata` object, nullable — 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. - `nickname` string, 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_features` string[] — The array of paths to pending Features in the Features hash. - `platform_restrictions` TreasuryFinancialAccountsResourcePlatformRestrictions — Restrictions that a Connect Platform has placed on this FinancialAccount. - `inbound_flows` 'restricted' | 'unrestricted', nullable — Restricts all inbound money movement. - `outbound_flows` 'restricted' | 'unrestricted', nullable — Restricts all outbound money movement. - `restricted_features` string[] — The array of paths to restricted Features in the Features hash. - `status` 'closed' | 'open', required — Status of this FinancialAccount. - `status_details` TreasuryFinancialAccountsResourceStatusDetails, required - `closed` TreasuryFinancialAccountsResourceClosedStatusDetails - `reasons` string[], required — The array that contains reasons for a FinancialAccount closure. - `supported_currencies` 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. ## Other responses - `default` — Error response. --- [API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)