### account_holder_token
- **Type**: uuid  
- **Required**: Yes  
- **Description**: Globally unique identifier for the account holder.

### Request body for creating a new beneficial owner or replacing the control person entity on an existing KYB account holder.

#### address
- **Type**: object  
- **Required**: Yes  
- **Description**: Individual's current address - PO boxes, UPS drops, and FedEx drops are not acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.

#### dob
- **Type**: string  
- **Required**: Yes  
- **Description**: Individual's date of birth, as an RFC 3339 date.

#### email
- **Type**: string  
- **Required**: Yes  
- **Description**: 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
- **Type**: string  
- **Required**: Yes  
- **Description**: Individual's first name, as it appears on government-issued identity documents.

#### last_name
- **Type**: string  
- **Required**: Yes  
- **Description**: Individual's last name, as it appears on government-issued identity documents.

#### phone_number
- **Type**: string  
- **Required**: Yes  
- **Description**: Individual's phone number, entered in E.164 format.

#### government_id
- **Type**: string  
- **Required**: Yes  
- **Description**: 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.

#### type
- **Type**: string enum  
- **Required**: Yes  
- **Description**: The type of entity to create on the account holder.  
Allowed: `BENEFICIAL_OWNER_INDIVIDUAL`, `CONTROL_PERSON`

#### Response:

##### 200 OK
- **Type**: object  
- **Description**: Response body for creating a new beneficial owner or replacing the control person entity on an existing KYB account holder.

###### account_holder_token
- **Type**: uuid  
- **Required**: Yes  
- **Description**: Globally unique identifier for the account holder.

###### created
- **Type**: date-time  
- **Required**: Yes  
- **Description**: Timestamp of when the entity was created.

###### status
- **Type**: string enum  
- **Required**: Yes  
- **Description**: Entity verification status.

###### status_reasons
- **Type**: array of objects  
- **Required**: Yes  
- **Description**: Reason for the evaluation status.

###### required_documents
- **Type**: array of objects  
- **Required**: Yes  
- **Description**: A list of documents required for the entity to be approved.

### Example Request
```bash
curl --request POST \
     --url https://sandbox.lithic.com/v1/account_holders/account_holder_token/entities \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "type": "BENEFICIAL_OWNER_INDIVIDUAL",
  "first_name": "Timmy",
  "last_name": "Turner",
  "dob": "1991-03-08T08:00:00Z",
  "email": "tim@left-earth.com",
  "phone_number": "+15555555555",
  "government_id": "211-23-1412",
  "address": {
    "address1": "300 Normal Forest Way",
    "city": "Portland",
    "country": "USA",
    "postal_code": "90210",
    "state": "OR"
  }
}
'```

### Example Response
```json
{
  "account_holder_token": "fa68ed76-9d02-4d45-8a3f-782f3b6a8b3f",
  "status": "ACCEPTED",
  "status_reasons": [],
  "token": "49c978db-20c4-46d8-9db4-b0ef28c03533",
  "created": "2024-09-16T20:13:41.865274",
  "required_documents": []
}
```
