Sign in
External Bank Accounts

Update an external account

patch/v1/external-bank-accounts/{id}

Path parameters

idstring required

External account ID

Headers

X-API-Keystring

API key

Request body

beneficiaryType'INDIVIDUAL' | 'BUSINESS'

Beneficiary type

beneficiaryNamestring

Beneficiary full name

beneficiaryPhonestring

Beneficiary phone number

beneficiaryDateOfBirthstring date

Account holder's date of birth

bankNamestring

Bank name

paymentRailsstring[]

Adds compatible payment rails to this account. Send the full resulting list (existing rails plus any to add). Existing rails cannot be removed.

Rails must be compatible with each other and with the account's stored bank details (e.g. add RTP to a US ACH/WIRE account; do not mix SEPA with a US routing-number account).

currencyCodesstring[]

Currency codes supported by this account. Only updatable for accounts with Hong Kong (CHATS) or SWIFT payment rails.

bankAccountType'checking' | 'savings'

Bank account type (checking or savings)

Example request

{
  "beneficiaryType": "INDIVIDUAL",
  "beneficiaryName": "John Smith",
  "beneficiaryAddress": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94102",
    "country": "US",
    "transliterated": {
      "addressLine1": "123 Main Street",
      "addressLine2": "Apt 4B",
      "city": "Beijing",
      "state": "Hebei"
    }
  },
  "beneficiaryPhone": "+1234567890",
  "beneficiaryDateOfBirth": "1990-01-31",
  "bankName": "JPMorgan Chase Bank",
  "bankAddress": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94102",
    "country": "US"
  },
  "paymentRails": [
    "ACH",
    "WIRE",
    "RTP"
  ],
  "currencyCodes": [
    "USD",
    "EUR",
    "GBP"
  ],
  "bankAccountType": "checking",
  "metadata": {
    "nickname": "Main Checking Account",
    "purpose": "Business operations",
    "tags": [
      "primary",
      "operations"
    ]
  }
}

Response

External account updated successfully

idstring required

Account ID

customerIdstring required

Customer ID

counterpartyIdstring nullable

Counterparty ID when this is a third-party recipient account

type'EXTERNAL_BANK' | 'EXTERNAL_PROXY' required

Account type

status'IN_REVIEW' | 'ACTIVE' | 'CLOSED' required

Account status

beneficiaryType'INDIVIDUAL' | 'BUSINESS' required

Beneficiary type

beneficiaryNamestring required

Beneficiary name

paymentRail'ACH' | 'ACH_SAME_DAY' | 'WIRE' | 'FEDWIRE' | 'FED_NOW' | 'RTP' | 'EREBOR' | 'EREBOR_RAIL' | 'BALANCE' | 'SWIFT' | 'SEPA' | 'SEPA_INSTANT' | 'TIPS' | 'FASTER_PAYMENTS' | 'BACS' | 'CHAPS' | 'ELIXIR' | 'NICS' | 'EFT' | 'INTERAC' | 'NPP' | 'BECS' | 'UPI' | 'IMPS' | 'IMPS_WITH_FIRC' | 'NEFT' | 'RTGS' | 'BI_FAST' | 'ARTAJASA' | 'PIX' | 'TED' | 'TEF' | 'SPEI' | 'COELSA' | 'SINPE' | 'CIPS' | 'CFXPS' | 'CHATS' | 'ZENGIN' | 'KFTC' | 'FAST_SG' | 'MEPS' | 'DUITNOW' | 'PROMPTPAY' | 'INSTAPAY' | 'PESONET' | 'NAPAS' | 'BEFTN' | 'SLIPS' | 'ZAHAV' | 'GHIPSS' | 'NIBSS' | 'PESALINK' | 'RTC_ZA' | 'TZS_RTGS' | 'EGP_ACH' | 'JOD_ACH' | 'NPSS' | 'MADA' | 'QPS' | 'DOP_ACH' | 'GTQ_ACH' | 'HNL_ACH' | 'PEN_ACH' | 'JMD_ACH' | 'USD_ACH_SV' | 'USD_ACH_EC' | 'CLP_TEF' | 'PSE' | 'COP_ACH' | 'BOB_RTGS' | 'PYG_ACH' | 'CERTIS' | 'DKK_TIPS' | 'SENT' | 'NKS' | 'BANKGIROT' | 'HKD_FPS' | 'IBFT' | 'TRY_FAST' required

Primary payment rail for this account

paymentRailsstring[]

All payment rails this account supports (bank accounts only)

beneficiaryPhonestring nullable

Beneficiary phone number

beneficiaryDateOfBirthstring date

Account holder's date of birth

bankNamestring nullable

Bank name (bank accounts only)

swiftBicstring nullable

SWIFT/BIC code (bank accounts only)

ibanstring nullable

IBAN (bank accounts only)

accountNumberstring nullable

Bank account number (bank accounts only)

routingNumberstring nullable

Bank routing code (ABA routing number, sort code, BSB, IFSC, etc.)

branchCodestring nullable

Bank branch code (for countries like Japan, Brazil, South Africa that use separate branch identifiers)

beneficiaryDocumentTypestring

Type of the beneficiary's national/tax identification document (rail-specific codes, e.g. CC/NIT for Colombia, RUT for Chile)

beneficiaryDocumentNumberstring

The beneficiary's national/tax identification document number

beneficiaryStateProvincestring

The beneficiary's state/department/province (rails that require it on payouts, e.g. Peru ACH)

correspondentBankNamestring nullable

Correspondent/intermediary bank name (SWIFT)

correspondentBankSwiftCodestring nullable

Correspondent/intermediary bank SWIFT/BIC code (SWIFT)

correspondentAccountNumberstring nullable

Correspondent/intermediary account number (SWIFT)

bankAccountType'checking' | 'savings' nullable

Bank account type (bank accounts only)

currencyCodesstring[] nullable

Supported currency codes

aliasType'PHONE' | 'EMAIL' | 'NATIONAL_ID' | 'TAX_ID' | 'RANDOM' | 'CORPORATE_ID' nullable

Type of proxy alias (proxy accounts only)

aliasValuestring nullable

The proxy alias value (proxy accounts only)

createdAtstring date-time required

Account creation date

updatedAtstring date-time required

Account last update date

createdboolean

Whether this account was newly created in this request or returned from an existing match

Example response

{
  "id": "eba_1234567890abcdef",
  "customerId": "cust_abc123",
  "counterpartyId": "cp_abc123",
  "type": "EXTERNAL_BANK",
  "status": "IN_REVIEW",
  "beneficiaryType": "INDIVIDUAL",
  "beneficiaryName": "John Smith",
  "metadata": {
    "nickname": "Main Checking Account",
    "purpose": "Business operations",
    "tags": [
      "primary",
      "operations"
    ]
  },
  "paymentRail": "SWIFT",
  "paymentRails": [
    "ACH",
    "ACH_SAME_DAY",
    "WIRE"
  ],
  "beneficiaryAddress": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Suite 100",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "beneficiaryPhone": "+12125551234",
  "beneficiaryDateOfBirth": "1990-01-31",
  "bankName": "JPMorgan Chase Bank",
  "bankAddress": {
    "addressLine1": "270 Park Avenue",
    "addressLine2": "Floor 10",
    "city": "New York",
    "state": "NY",
    "postalCode": "10017",
    "country": "US"
  },
  "swiftBic": "CHASUS33",
  "iban": "GB82WEST12345698765432",
  "accountNumber": "1234567890",
  "routingNumber": "021000021",
  "branchCode": "001",
  "beneficiaryDocumentType": "CC",
  "beneficiaryDocumentNumber": "12345678901",
  "beneficiaryStateProvince": "LIMA",
  "correspondentBankName": "Bank of America",
  "correspondentBankSwiftCode": "IRVTUS3NXXX",
  "correspondentAccountNumber": "9876543210",
  "bankAccountType": "checking",
  "currencyCodes": [
    "USD",
    "EUR"
  ],
  "aliasType": "TAX_ID",
  "aliasValue": "12345678901",
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T10:00:00Z",
  "created": true
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.