# 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 %}


---

# 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://docs.zapsign.com.br/espanol/cuenta/crear-usuarios-en-la-cuenta.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.