Update a Global Account

Update the nickname of an existing global account.
Request Parameters
idstring
required
Unique account identifier of the account to update.
nickNamestring
required
New user-defined account label. Not displayed on bank statements.
Response Parameters
resultResult
See Result.
idstring
Unique account identifier.
accountNamestring
Legal name of the account holder as registered with the bank.
nickNamestring
Updated user-defined account label.
accountTypestring
Account type at the bank. Currently only CHECKING is supported.
statusstring
Account lifecycle status. See GlobalAccountStatus.
closeReasonstring
Reason for account closure. Returned when status is CLOSED.
failureReasonstring
Reason for account creation failure. Returned when status is FAILED.
accountNumberstring
Bank account number. Returned when status is ACTIVE.
ibanstring
International Bank Account Number (IBAN). Returned when applicable.
swiftCodestring
SWIFT/BIC code. Returned when SWIFT is available.
institutionInstitution
Bank where the account is held.
Show child parametersShow child parameters
requiredFeaturesarray
Receiving capabilities requested at account creation.
Show child parametersShow child parameters
supportedFeaturesarray
Actual receiving capabilities provisioned for the account.
Show child parametersShow child parameters
createdAtdatetime
Timestamp when the account was created, following the ISO 8601 standard. See Data Types.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccess.N/A
ACCOUNT_STATUS_INVALIDFAccount status does not support this operation.Ensure the account is `ACTIVE` before updating.
ACCOUNT_AUTHORIZATION_REQUIREDFAccount is not authorized.Contact support for authorization.
Definition
POST /api/open/v1/globalAccounts/update
Request
{
"id": "2026032519121000470000009473",
"nickName": "My Updated Global Account"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "2026032519121000470000009473",
"accountName": "Sandbox Business",
"nickName": "My Updated Global Account",
"accountType": "CHECKING",
"status": "ACTIVE",
"accountNumber": "8484346726",
"iban": "IVAJPNIUM201000002",
"swiftCode": "CMFGUS33",
"institution": {
  "bankAddress": "",
  "branchCode": "",
  "bankName": "Example Bank Ltd",
  "bankRegion": "US"
},
"requiredFeatures": [
  {
    "currency": "USD",
    "paymentType": "LOCAL"
  }
],
"supportedFeatures": [
  {
    "type": "RECEIVING",
    "currency": "USD",
    "paymentNetwork": "ACH",
    "routingCodes": [
      {
        "type": "ACH",
        "value": "026073150"
      }
    ],
    "paymentType": "LOCAL"
  }
],
"createdAt": "2026-03-30T12:08:56+08:00"
}