---
title: "account_holder.updated"
method: POST
path: "account_holder.updated"
tags: ["Event Types"]
---

# account_holder.updated

`POST account_holder.updated` (webhook)

Occurs when an account_holder is updated.

## Payload

- union
  - object — KYB payload for an updated account holder.
    - `event_type` 'account_holder.updated', required — The type of event that occurred.
    - `token` string, uuid, required — The token of the account_holder that was created.
    - `update_request` object, required — Original request to update the account holder.
      - `beneficial_owner_individuals` Individual[] — You must submit a list of all direct and indirect individuals with 25% or more ownership in the company. A maximum of 4 beneficial owners can be submitted. If no individual owns 25% of the company you do not need to send beneficial owner information. See [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf) (Section I) for more background on individuals that should be included.
        - `address` Address
          - `address1` string, required — Valid deliverable address (no PO boxes).
          - `address2` string — Unit or apartment number (if applicable).
          - `city` string, required — Name of city.
          - `country` string, required — Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1 alpha-3 three-character format.
          - `postal_code` string, required — Valid postal code. Only USA ZIP codes are currently supported, entered as a five-digit ZIP or nine-digit ZIP+4.
          - `state` string, required — Valid state code. Only USA state codes are currently supported, entered in uppercase ISO 3166-2 two-character format.
        - `dob` string — Individual's date of birth, as an RFC 3339 date.
        - `email` string — Individual's email address. If utilizing Lithic for chargeback processing, this customer email address may be used to communicate dispute status and resolution.
        - `first_name` string — Individual's first name, as it appears on government-issued identity documents.
        - `last_name` string — Individual's last name, as it appears on government-issued identity documents.
        - `phone_number` string — Individual's phone number, entered in E.164 format.
        - `government_id` string — Government-issued identification number (required for identity verification and compliance with banking regulations). Social Security Numbers (SSN) and Individual Taxpayer Identification Numbers (ITIN) are currently supported, entered as full nine-digits, with or without hyphens
      - `business_entity` KybBusinessEntity
        - `address` Address, required
          - `address1` string, required — Valid deliverable address (no PO boxes).
          - `address2` string — Unit or apartment number (if applicable).
          - `city` string, required — Name of city.
          - `country` string, required — Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1 alpha-3 three-character format.
          - `postal_code` string, required — Valid postal code. Only USA ZIP codes are currently supported, entered as a five-digit ZIP or nine-digit ZIP+4.
          - `state` string, required — Valid state code. Only USA state codes are currently supported, entered in uppercase ISO 3166-2 two-character format.
        - `dba_business_name` string — Any name that the business operates under that is not its legal business name (if applicable).
        - `government_id` string, required — Government-issued identification number. US Federal Employer Identification Numbers (EIN) are currently supported, entered as full nine-digits, with or without hyphens.
        - `legal_business_name` string, required — Legal (formal) business name.
        - `parent_company` string, nullable — Parent company name (if applicable).
        - `phone_numbers` string[], required — One or more of the business's phone number(s), entered as a list in E.164 format.
      - `control_person` Individual
        - `address` Address
          - `address1` string, required — Valid deliverable address (no PO boxes).
          - `address2` string — Unit or apartment number (if applicable).
          - `city` string, required — Name of city.
          - `country` string, required — Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1 alpha-3 three-character format.
          - `postal_code` string, required — Valid postal code. Only USA ZIP codes are currently supported, entered as a five-digit ZIP or nine-digit ZIP+4.
          - `state` string, required — Valid state code. Only USA state codes are currently supported, entered in uppercase ISO 3166-2 two-character format.
        - `dob` string — Individual's date of birth, as an RFC 3339 date.
        - `email` string — Individual's email address. If utilizing Lithic for chargeback processing, this customer email address may be used to communicate dispute status and resolution.
        - `first_name` string — Individual's first name, as it appears on government-issued identity documents.
        - `last_name` string — Individual's last name, as it appears on government-issued identity documents.
        - `phone_number` string — Individual's phone number, entered in E.164 format.
        - `government_id` string — Government-issued identification number (required for identity verification and compliance with banking regulations). Social Security Numbers (SSN) and Individual Taxpayer Identification Numbers (ITIN) are currently supported, entered as full nine-digits, with or without hyphens
    - `external_id` string — A user provided id that can be used to link an account holder with an external system
    - `naics_code` string — 6-digit North American Industry Classification System (NAICS) code for the business. Only present if naics_code was included in the update request.
    - `nature_of_business` string — Short description of the company's line of business (i.e., what does the company do?). Values longer than 255 characters will be truncated before KYB verification
    - `website_url` string — Company website URL.
  - object — KYC payload for an updated account holder.
    - `event_type` 'account_holder.updated', required — The type of event that occurred.
    - `token` string, uuid, required — The token of the account_holder that was created.
    - `update_request` object, required — Original request to update the account holder.
      - `individual` Individual
        - `address` Address
          - `address1` string, required — Valid deliverable address (no PO boxes).
          - `address2` string — Unit or apartment number (if applicable).
          - `city` string, required — Name of city.
          - `country` string, required — Valid country code. Only USA is currently supported, entered in uppercase ISO 3166-1 alpha-3 three-character format.
          - `postal_code` string, required — Valid postal code. Only USA ZIP codes are currently supported, entered as a five-digit ZIP or nine-digit ZIP+4.
          - `state` string, required — Valid state code. Only USA state codes are currently supported, entered in uppercase ISO 3166-2 two-character format.
        - `dob` string — Individual's date of birth, as an RFC 3339 date.
        - `email` string — Individual's email address. If utilizing Lithic for chargeback processing, this customer email address may be used to communicate dispute status and resolution.
        - `first_name` string — Individual's first name, as it appears on government-issued identity documents.
        - `last_name` string — Individual's last name, as it appears on government-issued identity documents.
        - `phone_number` string — Individual's phone number, entered in E.164 format.
        - `government_id` string — Government-issued identification number (required for identity verification and compliance with banking regulations). Social Security Numbers (SSN) and Individual Taxpayer Identification Numbers (ITIN) are currently supported, entered as full nine-digits, with or without hyphens
    - `external_id` string — A user provided id that can be used to link an account holder with an external system
  - object — Legacy payload for an updated account holder.
    - `event_type` 'account_holder.updated', required — The type of event that occurred.
    - `business_account_token` string, uuid, nullable — If applicable, represents the business account token associated with the account_holder.
    - `created` string, date-time — When the account_holder updated event was created
    - `email` string — If updated, the newly updated email associated with the account_holder otherwise the existing email is provided.
    - `external_id` string, nullable — If applicable, represents the external_id associated with the account_holder.
    - `first_name` string — If applicable, represents the account_holder's first name.
    - `last_name` string — If applicable, represents the account_holder's last name.
    - `legal_business_name` string — If applicable, represents the account_holder's business name.
    - `phone_number` string — If updated, the newly updated phone_number associated with the account_holder otherwise the existing phone_number is provided.
    - `token` string, uuid, required — The token of the account_holder that was created.

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)