# Crear usuarios en la cuenta

Este endpoint permite la creación de nuevos usuarios vinculados a la organización a través de la API.

Al utilizar esta funcionalidad, es posible agregar nuevos miembros a la organización, configurando los niveles de permisos adecuados y garantizando que todos los datos necesarios, como contacto, correo electrónico, nombre, etc., se registren correctamente para el nuevo usuario.

{% hint style="danger" %}
**IIMPORTANTE**: Antes de que se complete la creación del nuevo usuario, se validará el número de usuarios disponibles en la organización. Si se ha alcanzado el límite, no será posible crear el nuevo usuario.
{% endhint %}

{% hint style="info" %}
El método de solicitud es POST. Si se utiliza PATCH o PUT, no se obtendrá el efecto deseado.
{% endhint %}

## Crear nuevos usuarios

<mark style="color:green;">`POST`</mark>`https://api.zapsign.com.br/api/v1/users/create-user`

### **Encabezado**

<table><thead><tr><th width="160">Nombre</th><th width="154">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>API token prefijo con la palabra "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</td></tr></tbody></table>

### Request Body

<table><thead><tr><th width="162">Name</th><th width="154">Type</th><th>Description</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>Correo electrónico del usuario. Cadena de hasta 255 caracteres y debe ser un correo electrónico válido. (Campo obligatorio)</td></tr><tr><td>role</td><td>string</td><td>Nivel de permiso del usuario dentro de la organización. Valores posibles: "member" (Miembro), "admin" (Administrador), "self_docs_limited" (Acceso limitado a los propios documentos). Predeterminado: "self_docs_limited".</td></tr><tr><td>first_name</td><td>string</td><td>Primer nombre del usuario. Cadena de hasta 255 caracteres.</td></tr><tr><td>last_name</td><td>string</td><td>Apellido del usuario. Cadena de hasta 255 caracteres.</td></tr><tr><td>phone_country</td><td>string</td><td>Código del país del usuario. (Ej: 55).</td></tr><tr><td>phone_number</td><td>string</td><td>Número de teléfono del usuario. (Ej: 11999999999).</td></tr></tbody></table>

{% hint style="warning" %}
El parámetro **email** es obligatorio para la creación del nuevo usuario. Si no se proporciona un valor en el cuerpo de la solicitud, no será posible agregar al usuario a la organización.
{% endhint %}

{% hint style="info" %}
**Aviso**: No es posible crear un nuevo usuario con permiso de 'propietario'.
{% endhint %}

### Request

```javascript
{
    "email":"loremipsum@email.com",
    "role":"admin",
    "first_name":"Lorem",
    "last_name":"Ipsum",
    "phone_country":"55",
    "phone_number":"11999999999"
}
```

### Response

{% tabs %}
{% tab title="200: OK" %}

```javascript
{
    "message": "Usuario creado con éxito."
}
```

{% endtab %}
{% endtabs %}