Skip to main content

Update Account

Update an existing StoneX brokerage account.

POST
/account-api/v1/update-account

Required Attributes

When using the update-account endpoint you are always required to send the below attributes. The remainder of the payload should only include the data blocks which are being updated.

AttributesData TypeLengthDescription
AccountNumberInteger3StoneX Account Number

Unique Identifiers

In order to update an item contained in an array you must pass the object's unique identifier. If no identifier is passed in the update the item will be appended as a new item to the array.

Data BlockIdentifier Attribute
associatedPartiescustomerId
transferOfDeathBeneficiariescustomerId
retirementBeneficiairestaxId
Customer ID

The customerId used to update the account is not the same as the onbCustomerID that was generated during account opening.

To get the customerId use the get-account endpoint.

Deleting Values

Deleting values is not currently supported

Attributes That Cannot Be Updated

  • accountNumber
  • subNumber
  • registrationType
  • accountName
  • nameType
  • main.marginIndicator
  • main.optionTradingIndicator
  • main.optionTradingLevel
  • primaryOwner.citizenshipCountry
  • primaryOwner.taxIdType
  • primaryOwner.taxIdNumber
  • additionalParty.customerId
  • additionalParty.citizenshipCountry
  • additionalParty.taxIdType
  • additionalParty.taxIdNumber
  • todBenes.id
  • retirementBenes.id