---
title: "Update an External Account"
method: PUT
path: "/customers/{customerID}/external_accounts/{externalAccountID}"
tags: ["External Accounts"]
---

# Update an External Account

`PUT /customers/{customerID}/external_accounts/{externalAccountID}`

## Request body

- UpdateExternalAccountInput
  - `address` Address
    - `street_line_1` string, required
    - `street_line_2` string
    - `city` string, required
    - `state` string — ISO 3166-2 subdivision code. Must be supplied for US addresses.
    - `postal_code` string — Must be supplied for countries that use postal codes.
    - `country` string, required — Three-letter alpha-3 country code as defined in the ISO 3166-1 spec.
  - `account` UsBankAccountUpdate
    - `checking_or_savings` 'checking' | 'savings' — Determines whether the US account is treated as checking or savings. All US accounts will be treated as checking by default.
    - `routing_number` string — The bank routing number

## Response `200`

External Account object updated

- union
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'us', required — Type of the bank account.
    - `currency` 'usd', required — Currency associated with the bank account. Must be `usd` for US accounts.
    - `account` UsBankAccount, required
      - `account_number` string, required — The bank account number
      - `routing_number` string, required — The bank routing number
      - `last_4` string, required — Last 4 digits of the bank account number
      - `checking_or_savings` 'checking' | 'savings' — Determines whether the US account is treated as checking or savings. All US accounts will be treated as checking by default.
    - `beneficiary_address_valid` boolean — Whether the beneficiary address is valid. A valid beneficiary address is required for all US External Accounts
    - `last_4` string — Last 4 digits of the bank account number. This field is getting deprecated in favor of the `account.last_4` field
    - `account_number` string — Account number of your bank account. This field is getting deprecated in favor of the `account.account_number` field for US accounts.
    - `routing_number` string — Routing number of your bank account. This field is getting deprecated in favor of the `account.routing_number` field for US accounts.
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'iban', required — Type of the bank account.
    - `currency` 'eur', required — Currency associated with the bank account. Must be `eur` for IBAN accounts.
    - `iban` unknown, required
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'unknown' | 'iban', required — Type of the bank account.
    - `currency` 'usd', required — Currency associated with the bank account.
    - `swift` unknown
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'clabe', required — Type of the bank account.
    - `currency` 'mxn', required — Currency associated with the bank account. Must be `mxn` for CLABE (SPEI) accounts.
    - `clabe` unknown, required
    - `account_validation` unknown
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `currency` 'brl', required — Currency associated with the bank account. Must be `brl` for Pix accounts.
    - `account_type` 'pix', required — Type of the bank account.
    - `pix_key` unknown
    - `br_code` unknown
    - `account_validation` unknown
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'gb', required — Type of the bank account.
    - `currency` 'gbp', required — Currency associated with the bank account. Must be `gbp` for GB accounts.
    - `account` unknown, required
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'bre_b', required — Type of the bank account.
    - `currency` 'cop', required — Currency associated with the bank account. Must be `cop` for Bre-B accounts.
    - `account` unknown, required
    - `account_validation` unknown
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable
  - object — Properties shared by all external account types
    - `id` string, required — A UUID that uniquely identifies a resource
    - `customer_id` string, required — The id of the Bridge customer that this External Account belongs to
    - `bank_name` string — Bank name of the account (e.g. "Chase")
    - `account_owner_name` unknown, required
    - `account_type` 'co_bank_transfer', required — Type of the bank account.
    - `currency` 'cop', required — Currency associated with the bank account. Must be `cop` for CO bank transfer accounts.
    - `account` object, required — CO bank transfer account display information. Returned in GET responses.
      - `last_4` string — Last 4 digits of the account number
      - `routing_number` string — The bank code of the account
    - `account_verification` object, nullable — Present for accounts with a holder verification check; contains the verification result keyed by account type.
      - `iban` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `gb` object
        - `match_level` 'pending' | 'match' | 'close_match' | 'no_match' | 'error'
        - `reason_code` string, nullable
        - `validated_account_owner_name` string, nullable
      - `requested_at` string, date-time
      - `completed_at` string, date-time, nullable

## Other responses

- `400` — Referenced by this API but not published in the vendor's docs pages.
- `401` — Missing or invalid API key
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)