Logo
API_DOC API Documentation

Update account holder details

POST {{baseUrl}}/updateAccountHolder

Updates the `accountHolderDetails` and `processingTier` of an account holder, and adds bank accounts and shareholders. When updating `accountHolderDetails`, parameters that are not included in the request are left unchanged except for the following object: * `metadata`: Updating the metadata replaces the entire object. This means that to update an existing key-value pair, you must provide the changes, as well as other existing key-value pairs. When updating any field in the following objects, you must submit all the fields required for validation: * `address` * `fullPhoneNumber` * `bankAccountDetails.BankAccountDetail` * `businessDetails.shareholders.ShareholderContact` For example, to update the `address.postalCode`, you must also submit the `address.country`, `.city`, `.street`, `.postalCode`, and possibly `.stateOrProvince` so that the address can be validated. To add a bank account or shareholder, provide the bank account or shareholder details without a `bankAccountUUID` or a `shareholderCode`.

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string




RESPONSES

status





Curl
curl -X POST 'https://cal-test.adyen.com/cal/services/Account/v3/updateAccountHolder' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"accountHolderCode":"CODE_OF_ACCOUNT_HOLDER","accountHolderDetails":{"address":{"city":"Amsterdam","country":"NL","postalCode":"12345","stateOrProvince":"NH","street":"Teststreet 1"},"email":"test@adyen.com","individualDetails":{"name":{"firstName":"First name","gender":"MALE","lastName":"Last Name"},"personalData":{"dateOfBirth":"1970-01-01","idNumber":"1234567890","nationality":"NL"}},"merchantCategoryCode":"7999","phoneNumber":{"phoneCountryCode":"NL","phoneNumber":"0612345678","phoneType":"Mobile"},"webAddress":"http: //www.accountholderwebsite.com"}}'

ENDPOINTS