Update an account

Changed on Sep 29, 2026

Updates a connected account by setting the values of the parameters passed. Any parameters not provided are left unchanged.

For accounts where controller.requirement_collection is application, which includes Custom accounts, you can update any information on the account.

For accounts where controller.requirement_collection is stripe, which includes Standard and Express accounts, you can update all information until you create an Account Link or Account Session to start Connect onboarding, after which some properties can no longer be updated.

To update your own account, use the Dashboard. Refer to our Connect documentation to learn more about updating accounts.

post/v1/accounts/{account}

Request

Base URL: https://api.stripe.com
URL: https://api.stripe.com/v1/accounts/{account}
Auth: one of:
- HTTP basic
- HTTP bearer

Path parameters

accountstring required

Request body application/x-www-form-urlencoded

account_tokenstring

An account token, used to securely provide details to the account.

business_type'company' | 'government_entity' | 'individual' | 'non_profit'

The business type. Once you create an Account Link or Account Session, this property can only be updated for accounts where controller.requirement_collection is application, which includes Custom accounts.

default_currencystring currency

Three-letter ISO currency code representing the default currency for the account. This must be a currency that Stripe supports in the account's country.

emailstring

The email address of the account holder. This is only to make the account easier to identify to you. If controller.requirement_collection is application, which includes Custom accounts, Stripe doesn't email the account without your consent.

expandstring[]

Specifies which fields in the response should be expanded.

external_accountstring

A card or bank account to attach to the account for receiving payouts (you won’t be able to use it for top-ups). You can provide either a token, like the ones returned by Stripe.js, or a dictionary, as documented in the external_account parameter for bank account creation. <br><br>By default, providing an external account sets it as the new default external account for its currency, and deletes the old default if one exists. To add additional external accounts without replacing the existing default for the currency, use the bank account or card creation APIs. After you create an Account Link or Account Session, this property can only be updated for accounts where controller.requirement_collection is application, which includes Custom accounts.

Response

Successful response.

business_type'company' | 'government_entity' | 'individual' | 'non_profit' nullable

The business type.

charges_enabledboolean

Whether the account can process charges.

countrystring

The account's country.

createdinteger

Time at which the account was connected. Measured in seconds since the Unix epoch.

default_currencystring

Three-letter ISO currency code representing the default currency for the account. This must be a currency that Stripe supports in the account's country.

details_submittedboolean

Whether account details have been submitted. Accounts with Stripe Dashboard access, which includes Standard accounts, cannot receive payouts before this is true. Accounts where this is false should be directed to an onboarding flow to finish submitting account details.

emailstring nullable

An email address associated with the account. It's not used for authentication and Stripe doesn't market to this field without explicit approval from the platform.

idstring required

Unique identifier for the object.

metadataobject

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.

object'account' required

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

payouts_enabledboolean

Whether the funds in this account can be paid out.

type'custom' | 'express' | 'none' | 'standard'

The Stripe account type. Can be standard, express, custom, or none.

Changes

Sep 29, 2026585b581504ae Revision changes
- warning
  added the new final_payment_failure enum value to the //////////// response property for the response status
- warning
  added the new first_payment_failure enum value to the //////////// response property for the response status
Sep 25, 20268b5c2f03d4cd Revision changes
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property ////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property /////////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ///////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property //////////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property /////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
- info
  added the optional property ////////////////////////// to the response with the status
This list may be incomplete.

Some revisions have not been checked yet.

Operation history (24 revisions)