---
title: "Changes to Add a new external account"
method: POST
path: "/customers/external-accounts"
---

# Changes to Add a new external account

`POST /customers/external-accounts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 24 revisions.

- **2026-08-20** `4f1f6b937f93` — 7 breaking, 7 info
- **2026-08-15** `27ff0fdca01c` — 7 breaking, 7 info
- **2026-08-14** `aaa1fb8782c8` — 3 warning
- **2026-08-13** `df12ec487f0e` — 1 warning
- **2026-08-11** `b06902b6595a` — 4 warning
- **2026-08-06** `526036c12609` — 1 warning
- **2026-08-05** `de0e47c1d15e` — 2 info
- **2026-07-31** `b21ed434ee6e` — 1 breaking, 47 warning, 59 info
- **2026-07-26** `094458a989d2` — 1 warning
- **2026-07-21** `483d0a08414b` — 1 warning

## Changes

- **2026-08-20** `4f1f6b937f93` — 7 breaking, 7 info
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #39: Base Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #40: Ethereum L1 Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #42: Polygon Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #43: Plasma Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #44: Solana Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #45: Spark Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #46: Tron Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #38: Base Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #39: Ethereum L1 Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #41: Polygon Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #42: Plasma Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #43: Solana Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #44: Spark Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletCustodyFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #45: Tron Wallet]/` response property `allOf` list for the response status `201`
- **2026-08-15** `27ff0fdca01c` — 7 breaking, 7 info
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #39: Base Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #40: Ethereum L1 Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #42: Polygon Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #43: Plasma Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #44: Solana Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #45: Spark Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #46: Tron Wallet]/` request property `allOf` list
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #38: Base Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #39: Ethereum L1 Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #41: Polygon Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #42: Plasma Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #43: Solana Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #44: Spark Wallet]/` response property `allOf` list for the response status `201`
  - added `#/components/schemas/WalletBeneficiaryFields` to the `allOf[subschema #1]/accountInfo/oneOf[subschema #45: Tron Wallet]/` response property `allOf` list for the response status `201`
- **2026-08-14** `aaa1fb8782c8` — 3 warning
  - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
  - added the new `PENDING_OWNERSHIP_VERIFICATION` enum value to the `allOf[subschema #1]/status` response property for the response status `201`
  - added the new `UNVERIFIED` enum value to the `allOf[subschema #1]/status` response property for the response status `201`
- **2026-08-13** `df12ec487f0e` — 1 warning
  - added the new `TRANSACTION_SIZE_LIMIT_EXCEEDED` enum value to the `code` response property for the response status `400`
- **2026-08-11** `b06902b6595a` — 4 warning
  - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400`
  - added the new `CARD_ALREADY_CLOSED` enum value to the `code` response property for the response status `409`
  - added the new `CARD_NOT_MUTABLE` enum value to the `code` response property for the response status `409`
  - added the new `INVALID_STATE_TRANSITION` enum value to the `code` response property for the response status `409`
- **2026-08-06** `526036c12609` — 1 warning
  - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400`
- **2026-08-05** `de0e47c1d15e` — 2 info
  - added the new optional request property `allOf[subschema #1]/ownershipType`
  - added the optional property `allOf[subschema #1]/ownershipType` to the response with the `201` status
- **2026-07-31** `b21ed434ee6e` — 1 breaking, 47 warning, 59 info
  - added `#/components/schemas/PlasmaWalletExternalAccountInfo` to the `allOf[subschema #1]/accountInfo` response property `oneOf` list for the response status `201`
  - added the new `BENEFICIARY_TRUSTED` enum value to the `code` response property for the response status `409`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #10: GBP Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #11: GHS Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #12: GTQ Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #13: HKD Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #14: HTG Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #15: IDR Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #16: INR Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #17: JMD Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #18: KES Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #19: MWK Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #1: AED Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #20: MXN Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #21: MYR Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #22: NGN Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #23: PHP Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #24: PKR Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #25: RWF Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #26: SGD Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #27: SLV Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #28: THB Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #29: TZS Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #2: BDT Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #30: UGX Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #31: USD Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #32: VND Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #33: XAF Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #34: XOF Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #35: ZAR Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #36: ZMW Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #37: SWIFT Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #38: Base Wallet]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #39: Ethereum L1 Wallet]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #3: BRL Account]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #40: Lightning]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #41: Polygon Wallet]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #42: Solana Wallet -> subschema #43: Solana Wallet]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #43: Spark Wallet -> subschema #44: Spark Wallet]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - added the new `PLASMA_WALLET` enum value to the `allOf[subschema #1]/accountInfo/oneOf[subschema #44: Tron Wallet -> subschema #45: Tron Wallet]/allOf[#/components/schemas/BaseExternalAccountInfo]/accountType` response property for the response status `201`
  - …67 more
- **2026-07-26** `094458a989d2` — 1 warning
  - added the new `TRANSACTION_NOT_CANCELLABLE` enum value to the `code` response property for the response status `409`
- **2026-07-21** `483d0a08414b` — 1 warning
  - added the new `PASSKEY_ALREADY_ENROLLED` enum value to the `code` response property for the response status `409`

---

[Operation](https://skmtc.dev/stainless-api/apis/grid-api/docs/customers/external-accounts/post.md) · [API](https://skmtc.dev/stainless-api/apis/grid-api.md) · [Page](https://skmtc.dev/stainless-api/apis/grid-api/changes/customers/external-accounts/post)