> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear clientes

> Crea un nuevo cliente en tu cuenta.

### Headers

<ParamField header="x-idempotency" type="string" required placeholder="Token único para garantizar la idempotencia de la petición">
  Token único para garantizar la idempotencia de la petición
</ParamField>

### Body

<ParamField body="user_type" type="string" required placeholder="natural, company">
  Tipo de usuario, valores permitidos: natural, company
</ParamField>

<ParamField body="first_name" type="string" required>
  Primer Nombre del cliente
</ParamField>

<ParamField body="last_name" type="string" required>
  Apellidos Nombre del cliente
</ParamField>

<ParamField body="email" type="string" required>
  Correo electrónico del cliente
</ParamField>

<ParamField body="phone" type="string" required>
  Número de teléfono del cliente usa el prefijo de la región ejemplo: +57
</ParamField>

<ParamField body="document_type" type="string" required placeholder="CC, CE, NIT, PASSPORT">
  Tipo de documento de identidad (CC, CE, NIT, PASSPORT)
</ParamField>

<ParamField body="document_number" type="string" required>
  Número de documento de identidad
</ParamField>

### Response

<ResponseField name="id" type="string">
  Identificador único del cliente en formato UUID
</ResponseField>

<ResponseField name="name" type="string">
  Nombre del cliente
</ResponseField>

<ResponseField name="email" type="string">
  Correo electrónico del cliente
</ResponseField>

<ResponseField name="phone" type="string">
  Número de teléfono del cliente
</ResponseField>

<ResponseField name="document_number" type="string">
  Número de documento de identidad del cliente
</ResponseField>

<ResponseField name="document_type" type="string">
  Tipo de documento de identidad del cliente (ej. DNI, RUC, CE)
</ResponseField>

<ResponseField name="created_at" type="date">
  Fecha y hora de creación del cliente
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id":"9da58912-101d-46f8-86c9-20a52119c0bf",
    "first_name":"John",
    "last_name":"Doe",
    "email":"john.doe@example.com",
    "phone":"+573100001020",
    "document_type":"CC",
    "document_number":"1060500333",
    "created_at":"2024-12-04T20:09:08.000000Z"
  }
  ```

  ```json 422 theme={null}
  {
     "message":"El campo nombre es obligatorio. (y 6 errores m\u00e1s)",
     "code":10001,
     "code_name":"validation_error",
     "errors":{
        "first_name":[
           "El campo nombre es obligatorio."
        ],
        "last_name":[
           "El campo apellido es obligatorio."
        ],
        "phone":[
           "El campo tel\u00e9fono es obligatorio."
        ],
        "email":[
           "El campo correo electr\u00f3nico es obligatorio."
        ],
        "user_type":[
           "El campo user type es obligatorio."
        ],
        "document_type":[
           "El campo document type es obligatorio."
        ],
        "document_number":[
           "El campo document number es obligatorio."
        ]
     }
  }
  ```

  ```json 409 theme={null}
  {
    "message": "No se puede generar la operación, genera un token de idempotencia y envíelo en los headers como x-idempotency",
    "code": 10003,
    "code_name": "idempotency_error"
  }
  ```
</ResponseExample>