> For the complete documentation index, see [llms.txt](https://docs.musepay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.musepay.io/reference/api-reference/kyc-api/create-applicant.md).

# Create Applicant

{% hint style="warning" %}
Every request must include the [common parameters](https://docs.musepay.io/reference/api-reference/common-parameters.md). The example below shows business fields only.
{% endhint %}

<mark style="color:green;">`POST`</mark> `/v1/kyc/applicant/create`

Registers a verification user under your merchant account. No fee, and no identity verification yet: nothing is created at the verification provider until the user opens a link and submits their information.

## Request Body

| Name        | Type   | Required | Description                                                                                                              |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| request\_id | String | Yes      | Identifier for this request. Use a new value each time.                                                                  |
| user\_xid   | String | Yes      | Stable user identifier in your system, unique within your merchant account. Use the same value for link and query calls. |
| email       | String | Yes      | User email address in a valid format.                                                                                    |
| user\_name  | String | No       | Display name; defaults to `user_xid`. Not a document-verified name.                                                      |

## Request Example

```json
{
  "request_id": "kyc-create-202610150001",
  "user_xid": "customer-0001",
  "email": "customer-0001@example.com",
  "user_name": "Example User"
}
```

## Response Body

The following fields are returned in `data`.

| Name        | Type   | Description                                               |
| ----------- | ------ | --------------------------------------------------------- |
| request\_id | String | Identifier for this request.                              |
| user\_xid   | String | Merchant-side user identifier.                            |
| user\_id    | String | MusePay user ID. Save it and associate it with your user. |

```json
{
  "code": "200",
  "message": "success",
  "data": {
    "request_id": "kyc-create-202610150001",
    "user_xid": "customer-0001",
    "user_id": "1000001"
  }
}
```

## Errors

`209005` — the email is already used by another `user_xid` under your account. Register with a different email.

## Calling it again

For an existing `user_xid`, the same `user_id` is returned and the stored email and name are not updated. Matched on merchant and `user_xid`, not on `request_id`, so a new `request_id` does not update the profile.

Next: [Get Verification Link](https://docs.musepay.io/reference/api-reference/kyc-api/link.md).
