--- title: "Account holder updated" method: POST path: "balancePlatform.accountHolder.updated" tags: ["Account holder"] --- # Account holder updated `POST balancePlatform.accountHolder.updated` (webhook) Adyen sends this webhook when you successfully [update an account holder](https://docs.adyen.com/api-explorer/balanceplatform/latest/patch/accountHolders/_id_). ## Payload - AccountHolderNotificationRequest - `data` AccountHolderNotificationData, required - `accountHolder` AccountHolder - `balancePlatform` string — The unique identifier of the [balance platform](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/get/balancePlatforms/{id}__queryParam_id) to which the account holder belongs. Required in the request if your API credentials can be used for multiple balance platforms. - `capabilities` object — Contains key-value pairs that specify the actions that an account holder can do in your platform. The key is a capability required for your integration. For example, **issueCard** for Issuing. The value is an object containing the settings for the capability. - `contactDetails` ContactDetails - `address` Address, required - `city` string, required — The name of the city. Maximum length: 3000 characters. - `country` string, required — The two-character ISO-3166-1 alpha-2 country code. For example, **US**. > If you don't know the country or are not collecting the country from the shopper, provide `country` as `ZZ`. - `houseNumberOrName` string, required — The number or name of the house. Maximum length: 3000 characters. - `postalCode` string, required — A maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries. - `stateOrProvince` string — The two-character ISO 3166-2 state or province code. For example, **CA** in the US or **ON** in Canada. > Required for the US and Canada. - `street` string, required — The name of the street. Maximum length: 3000 characters. > The house number should not be included in this field; it should be separately provided via `houseNumberOrName`. - `email` string, required — The email address of the account holder. - `phone` Phone, required - `number` string, required — The full phone number provided as a single string. For example, **"0031 6 11 22 33 44"**, **"+316/1122-3344"**, or **"(0031) 611223344"**. - `type` 'Landline' | 'Mobile', required — Type of phone number. Possible values: **Landline**, **Mobile**. - `webAddress` string — The URL of the account holder's website. - `description` string — Your description for the account holder. - `id` string, required — The unique identifier of the account holder. - `legalEntityId` string, required — The unique identifier of the [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id) associated with the account holder. Adyen performs a verification process against the legal entity of the account holder. - `metadata` object — A set of key and value pairs for general use. The keys do not have specific names and may be used for storing miscellaneous data as desired. > Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs. - `migratedAccountHolderCode` string — The unique identifier of the migrated account holder in the classic integration. - `primaryBalanceAccount` string — The ID of the account holder's primary balance account. By default, this is set to the first balance account that you create for the account holder. To assign a different balance account, send a PATCH request. - `reference` string — Your reference for the account holder. - `status` 'Active' | 'Closed' | 'Inactive' | 'Suspended' — The status of the account holder. Possible values: * **active**: The account holder is active and allowed to use its capabilities. This is the initial status for account holders and balance accounts. You can change this status to **suspended** or **closed**. * **suspended**: The account holder is temporarily disabled and payouts are blocked. You can change this status to **active** or **closed**. * **closed**: The account holder and all of its capabilities are permanently disabled. This is a final status and cannot be changed. - `timeZone` string — The time zone of the account holder. For example, **Europe/Amsterdam**. Defaults to the time zone of the balance platform if no time zone is set. For possible values, see the [list of time zone codes](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). - `verificationDeadlines` VerificationDeadline[] — List of verification deadlines and the capabilities that will be disallowed if verification errors are not resolved. - `capabilities` string[], required — The names of the capabilities to be disallowed. - `entityIds` string[] — The unique identifiers of the bank account(s) that the deadline applies to - `expiresAt` string, date-time, required — The date that verification is due by before capabilities are disallowed. - `balancePlatform` string — The unique identifier of the balance platform. - `environment` string, required — The environment from which the webhook originated. Possible values: **test**, **live**. - `timestamp` string, date-time — When the event was queued. - `type` 'balancePlatform.accountHolder.updated' | 'balancePlatform.accountHolder.created', required — Type of webhook. ## Acknowledgement `200` OK - the request has succeeded. - BalancePlatformNotificationResponse - `notificationResponse` string — Respond with any **2xx** HTTP status code to [accept the webhook](https://docs.adyen.com/development-resources/webhooks/#accept-webhooks). --- [API](https://skmtc.dev/adyen/apis/configuration-webhooks.md) · [All operations](https://skmtc.dev/adyen/apis/configuration-webhooks/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/configuration-webhooks/revisions/74e0766552b1/schema)