# Create an Individual Client

<mark style="color:green;">`POST`</mark> `{{baseurl}}/v1/api/actors`

This endpoint allows you to create an individual client, also known as an individual actor or entity, depending on your nomenclature. This is typically an individual you have a business or commercial relationship with.&#x20;

### Header

| Name                                    | Type   | Description |
| --------------------------------------- | ------ | ----------- |
| token<mark style="color:red;">\*</mark> | String | API token   |

### **Body**

| Field                                                    | Type      | Description                                                                                                                                                                                |
| -------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| actorType<mark style="color:red;">\*</mark>              | String    | type of actor <mark style="color:red;">`one of "individual" or "legal_entity"`</mark>.                                                                                                     |
| externalAccountId<mark style="color:red;">\*</mark>      | String    | external identifier for the client.                                                                                                                                                        |
| firstName<mark style="color:red;">\*</mark>              | String    | first name of the actor <mark style="color:red;">`required, if actorType is individual`</mark>.                                                                                            |
| lastName<mark style="color:red;">\*</mark>               | String    | last name of the actor <mark style="color:red;">`required, if actorType is individual`</mark>.                                                                                             |
| middleName                                               | String    | middle name of the actor <mark style="color:red;">`applies, if actorType is individual`</mark>.                                                                                            |
| gender                                                   | String    | gender of the actor <mark style="color:red;">`applies, if actorType is individual`</mark>.                                                                                                 |
| nationality                                              | String    | nationality of the actor <mark style="color:red;">`applies, if actorType is individual`</mark>.                                                                                            |
| sourceOfIncome                                           | String    | source of income of the actor <mark style="color:red;">`applies, if actorType is individual`</mark>.                                                                                       |
| occupation                                               | String    | occupation of the actor <mark style="color:red;">`applies, if actorType is individual`</mark>.                                                                                             |
| industry<mark style="color:red;">\*</mark>               | String    | industry of the actor's occupation <mark style="color:red;">`required, if actorType is individual`</mark>.                                                                                 |
| customerSegmentation<mark style="color:red;">\*</mark>   | String\[] | Array of strings of actor category based on business customer segmentation <mark style="color:red;">`applies, for both types`</mark>.                                                      |
| dateOfBirth                                              | String    | date of birth of the actor <mark style="color:red;">`applies, if actorType is individual`</mark>.                                                                                          |
| accountNumbers<mark style="color:red;">\*</mark>         | Object\[] | array of account numbers belonging to the actor <mark style="color:red;">`required, for both types`</mark>.                                                                                |
| accountType<mark style="color:red;">\*</mark>            | String    | type of account.                                                                                                                                                                           |
| accountNumber<mark style="color:red;">\*</mark>          | String    | account number.                                                                                                                                                                            |
| domicile                                                 | String    | country code where account is domiciled.                                                                                                                                                   |
| accountCreationDate<mark style="color:red;">\*</mark>    | String    | Date account number was created.                                                                                                                                                           |
| phones<mark style="color:red;">\*</mark>                 | Object\[] | Array of phone numbers belonging to the actor<mark style="color:red;">`required, if actorType is individual`</mark>.                                                                       |
| numberType                                               | String    | type of the phone number <mark style="color:red;">`can be, "personal" or "office"`</mark>.                                                                                                 |
| countryCode<mark style="color:red;">\*</mark>            | String    | country code.                                                                                                                                                                              |
| phone<mark style="color:red;">\*</mark>                  | String    | phone number.                                                                                                                                                                              |
| socials                                                  | Object\[] | Array of social media accounts belonging to the actor <mark style="color:red;">`applies, for both types`</mark>.                                                                           |
| type                                                     | String    | social media platform of the social account.                                                                                                                                               |
| handle                                                   | String    | social media handle of the social account.                                                                                                                                                 |
| emails                                                   | Object\[] | Array of email addresses belonging to the actor <mark style="color:red;">`required, if actorType is individual`</mark>.                                                                    |
| emailType                                                | String    | type of the email account <mark style="color:red;">`can be, "personal" or "offic`</mark>`e"`.                                                                                              |
| address                                                  | String    | address of the email account.                                                                                                                                                              |
| governmentIds<mark style="color:red;">\*</mark>          | Object\[] | Array of government Ids belonging to the actor <mark style="color:red;">`required, if actorType is individual`</mark>.                                                                     |
| idType<mark style="color:red;">\*</mark>                 | String    | Type of ID.                                                                                                                                                                                |
| value<mark style="color:red;">\*</mark>                  | String    | number of ID.                                                                                                                                                                              |
| issuingAuthority                                         | String    | organisation issuing the ID.                                                                                                                                                               |
| expirationDate                                           | String    | Date the ID expires.                                                                                                                                                                       |
| addresses<mark style="color:red;">\*</mark>              | Object\[] | Array of addresses belonging to the actor <mark style="color:red;">`required, for both types`</mark>.                                                                                      |
| addressType                                              | String    | type of the address <mark style="color:red;">`can be, "home" or "office`</mark>`"`.                                                                                                        |
| line1<mark style="color:red;">\*</mark>                  | String    | address line 1                                                                                                                                                                             |
| line2                                                    | String    | address line 2                                                                                                                                                                             |
| postCode<mark style="color:red;">\*</mark>               | String    | post/zip code                                                                                                                                                                              |
| city<mark style="color:red;">\*</mark>                   | String    | address city                                                                                                                                                                               |
| state<mark style="color:red;">\*</mark>                  | String    | address state/province                                                                                                                                                                     |
| country<mark style="color:red;">\*</mark>                | String    | address country                                                                                                                                                                            |
| lengthOfStay<mark style="color:red;">\*</mark>           | String    | length of stay in address <mark style="color:red;">`in months`</mark>                                                                                                                      |
| legalEntity<mark style="color:red;">\*</mark>            | Object    | details of incorporation if the actor is a legal entity <mark style="color:red;">`required, if actorType is legal_entity`</mark>.                                                          |
| dateOfRegistration                                       | String    | Date of registration of business                                                                                                                                                           |
| type<mark style="color:red;">\*</mark>                   | String    | type of business entity                                                                                                                                                                    |
| registrationNumber<mark style="color:red;">\*</mark>     | String    | business registration number                                                                                                                                                               |
| industryClassification<mark style="color:red;">\*</mark> | String    | industry of business                                                                                                                                                                       |
| url                                                      | String    | website url of business                                                                                                                                                                    |
| countryOfIncorporation                                   | String    | country of Incorporation of business                                                                                                                                                       |
| legalEntityDirectors<mark style="color:red;">\*</mark>   | Object\[] | details of directors of the business <mark style="color:red;">`at least one director is required, if actorType is legal_entity`</mark>.                                                    |
| name<mark style="color:red;">\*</mark>                   | String    | name of director                                                                                                                                                                           |
| sourceOfIncome<mark style="color:red;">\*</mark>         | String    | source of income of director                                                                                                                                                               |
| industry<mark style="color:red;">\*</mark>               | String    | industry of director                                                                                                                                                                       |
| phoneNumbers<mark style="color:red;">\*</mark>           | Object\[] | Array of phone numbers belonging to director                                                                                                                                               |
| countryCode<mark style="color:red;">\*</mark>            | String    | country code                                                                                                                                                                               |
| phone<mark style="color:red;">\*</mark>                  | String    | phone number                                                                                                                                                                               |
| emails<mark style="color:red;">\*</mark>                 | String\[] | Array of emails belonging to director                                                                                                                                                      |
| uniqueIdentifier<mark style="color:red;">\*</mark>       | Object\[] | ID of director                                                                                                                                                                             |
| issuingCountry<mark style="color:red;">\*</mark>         | String    | Issuing Country of ID                                                                                                                                                                      |
| idType<mark style="color:red;">\*</mark>                 | String    | type of ID                                                                                                                                                                                 |
| idNumber<mark style="color:red;">\*</mark>               | String    | Number of ID                                                                                                                                                                               |
| kycVerifiedBy<mark style="color:red;">\*</mark>          | String    | KYC verified By one of <mark style="color:red;">`youverify - if KYC was verified by youverify, client - if KYC was verified by client, not_verified - if KYC has not been verified`</mark> |
| verificationId                                           | String    | youverify KYC verification ID - <mark style="color:red;">`if KYC was verified by youverify`</mark>                                                                                         |

{% tabs %}
{% tab title="Sample Request for Individuals" %}

```json
{
      "actorType": "individual",
      "firstName": "Confidence",
      "lastName": "Sunday",
      "middleName": "Mogaji",
      "dateOfBirth": "1985-03-05",
      "nationality": "NG",
      "gender": "male",
      "sourceOfIncome": "business",
      "occupation": "product manager",
      "industry": "technology",
      "KycVerifiedBy": "youverify",
      "verificationId": "642eb06f0d84552686540c36",
      "uniqueIdentifier": {
        "type": "bvn",
        "idNumber": "000000000"
        },
      "customerSegmentation": ["tech talents", "high profile"],
      "accountNumbers": [
                    {
                     "accountType": "savings",
                     "accountNumber": "00000000000",
                     "domicile": "NG",
                     "accountCreationDate": "2013-09-09"
                    }
                ],
      "phones": [
                   {
                     "numberType": "personal",
                     "phone": "00000000000",
                     "countryCode": "234"
                   },
                   {
                     "numberType": "office",
                     "phone": "00000000000"
                   }
               ],
      "socials": [
                   {
                     "type": "twitter",
                     "handle": "john_doe"
                   },
                   {
                     "type": "instagram",
                     "handle": "prettyJohn"
                   }
               ],
      "emails": [
                   {
                     "emailType": "personal",
                     "address": "johndoe@gmail.com"
                   }
               ],
      "governmentIds": [
                   {
                     "idType": "nin",
                     "value": "11111111111",
                     "issuingAuthority": "nimc",
                     "expirationDate": "2024-05-24",
                   }
               ],
     "addresses": [
                   {
                     "addressType": "home",
                     "line1": "35 Wellsfargo",
                     "line2": "apt 3",
                     "postCode": "2222222",
                     "city": "garden heights",
                     "state": "New York",
                     "country": "US",
                     "lengthOfStay": "20"
                   }
               ]
     
  }
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Success Response for Individual" %}

```json
{
"success": true,
"statusCode": 201,
"message": "Actor created successfully!",
"data": {
    "parentId": null,
    "isDeleted": false,
    "businessId": "628b38f03ae28a14f52d4bf7",
    "actorType": "individual",
    "firstName": "Confidence",
    "lastName": "Sunday",
    "middleName": "Mogaji",
    "dateOfBirth": "1985-04-21",
    "sourceOfIncome": "business",
    "occupation": "product manager",
    "industry": "technology",
    "customerSegmentation": ["tech talents", "high profile"],
    "nationality": "NG",
    "gender": "male",
    "KycVerifiedBy": "youverify",
    "verificationId": "642eb06f0d84552686540c36",
    "uniqueIdentifier": {
        "type": "bvn",
        "idNumber": "000000000"
    },
    "accountNumbers": [
        {
            "_id": "642eb06f0d8455d0d0540c2f",
            "accountType": "savings",
            "accountNumber": "00000000000",
            "domicile": "NG",
            "accountCreationDate": "2013-09-09"
        }
    ],
    "phones": [
        {
            "_id": "642eb06f0d8455210f540c30",
            "numberType": "personal",
            "phone": "00000000000",
            "countryCode": "234"
        },
        {
            "_id": "642eb06f0d8455964a540c31",
            "numberType": "office",
            "phone": "00000000000"
        }
    ],
    "socials": [
        {
            "_id": "642eb06f0d8455652c540c32",
            "type": "twitter",
            "handle": "john_doe"
        },
        {
            "_id": "642eb06f0d8455f043540c33",
            "type": "instagram",
            "handle": "prettyJohn"
        }
    ],
    "emails": [
        {
            "_id": "642eb06f0d8455f762540c34",
            "emailType": "personal",
            "address": "johndoe@gmail.com"
        }
    ],
    "governmentIds": [
        {
            "_id": "642eb06f0d84555d43540c35",
            "idType": "nin",
            "value": "11111111111",
            "issuingAuthority": "nimc",
            "expirationDate": "2025-04-21",
        }
    ],
    "addresses": [
        {
            "_id": "642eb06f0d84552686540c36",
            "addressType": "home",
            "line1": "35 Wellsfargo",
            "line2": "apt 3",
            "postCode": "2222222",
            "city": "garden heights",
            "state": "New York",
            "country": "US",
            "lengthOfStay": "15",
            "dateAdded": "2023-04-06T11:43:43.507Z",
            "lastModifiedAt": "2023-04-06T11:43:43.507Z"
        }
    ],
    "createdAt": "2023-04-06T11:43:43.508Z",
    "lastModifiedAt": "2023-04-06T11:43:43.508Z",
    "_createdAt": "2023-04-06T11:43:4343+00:00",
    "_lastModifiedAt": "2023-04-06T11:43:4343+00:00",
    "id": "642eb06f0d84555c0f540c2e"
},
"links": []
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Error Response" %}

```json
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.youverify.co/know-your-transaction-service-kyt/customer-management/create-an-individual-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.