# Crear cuenta

#### **Esta estructura es ideal para socios que desean gestionar múltiples operaciones dentro de una única estructura, manteniendo:**

* Separación de documentos y usuarios por cuenta;
* Permisos ajustados por equipo o cliente;
* Informes y consumo organizados por unidad;
* Integraciones independientes para cada cuenta (con tokens únicos por cuenta).

{% hint style="danger" %}
**Importante**: Solo las cuentas con esta funcionalidad activa podrán utilizar este endpoint. Si aún no tienes acceso, [ponte en contacto con el equipo comercial.](https://zapsign.co/es/hablar-con-ventas)
{% endhint %}

### **Cómo funciona**

Al hacer una solicitud a este endpoint:

1. Se creará una nueva cuenta (organización) dentro de ZapSign.
2. El propietario de la cuenta principal (quien realiza la solicitud) también será el propietario de la nueva cuenta creada. Esto garantiza control total sobre las cuentas asociadas.
3. El correo electrónico proporcionado en la solicitud se agregará a la nueva cuenta con el rol de **Miembro**. En caso de no enviar un correo electrónico, la nueva cuenta sólo tendrá un usuario que es el propietario.
   * Un **Miembro** puede ver todos los documentos de la cuenta, pero no tiene acceso a la configuración de la plataforma.
4. En caso de informar un correo electrónico en la requisición, el usuario invitado recibirá un correo electrónico de ZapSign para crear una contraseña y acceder a su cuenta.

### Facturación y gestión de cuentas asociadas

> <mark style="color:red;">**⚠️ Atención:**</mark> <mark style="color:red;"></mark><mark style="color:red;">Todo el consumo de las cuentas asociadas será responsabilidad de la cuenta principal (socio).</mark>

Esto incluye:

* Creación de documentos;
* Consultas de antecedentes;
* Envío de documentos por WhatsApp;
* Métodos de autenticación avanzada (como reconocimiento facial, certificado digital, etc.).

La cuenta principal tendrá acceso a un panel consolidado con todo el consumo y los documentos generados por las cuentas asociadas.

Si es necesario suspender temporalmente el acceso a una cuenta asociada, puedes utilizar el endpoint **Actualizar estado de pago**.

## **Crear una cuenta de socio**

<mark style="color:green;">`POST`</mark> `https://api.zapsign.com.br/api/v1/partner/company/`

**Headers**

<table><thead><tr><th width="143">Name</th><th width="105">Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td>Token de API precedido por el texto "Bearer".<br>Ejemplo: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</td></tr></tbody></table>

#### Request Body

<table><thead><tr><th width="156">Name</th><th width="116">Type</th><th>Description</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>Correo electrónico del nuevo usuario que será añadido como miembro.</td></tr><tr><td>country<mark style="color:red;">*</mark></td><td>string</td><td>País de la nueva cuenta. Valores posibles: br, mx, co, pe, cl</td></tr><tr><td>lang<mark style="color:red;">*</mark></td><td>string</td><td>Idioma de la nueva empresa. Opciones: "pt-br" (portugués), "es" (español), "en" (inglés). Por defecto: "pt-br"</td></tr><tr><td>company_name<mark style="color:red;">*</mark></td><td>string</td><td>Nombre de la nueva empresa.</td></tr><tr><td>phone_country</td><td>string</td><td>Código de país del número de teléfono del nuevo usuario.</td></tr><tr><td>phone_number</td><td>string</td><td>Número de teléfono del nuevo usuario.</td></tr><tr><td>primary_color</td><td>string</td><td>Color primario opcional utilizado en la identidad visual de la empresa (por ejemplo, código HEX o identificador interno).</td></tr><tr><td>logo_url</td><td>string</td><td>Logotipo opcional de la empresa codificado en Base64, representando el archivo de imagen.</td></tr></tbody></table>

{% tabs %}
{% tab title="Ejemplo de Payload" %}

```json
{
    "email": "email@email",
    "phone_number": "11111111111",
    "phone_country": "55",
    "country": "co",
    "lang": "es",
    "company_name": "New Company LTDA"
}
```

{% endtab %}
{% endtabs %}

### Response

{% tabs %}
{% tab title="200 OK – Cuenta creada exitosamente" %}

```json
{
    "id": 543,
    "name": "New Company LTDA",
    "api_token": "010234xx-23ed-44ab-8b57-9XXXXe03cc5e-cc71-4911-bf29-3bxxxx140540",
    "created_at": "2025-04-04T22:35:16.821400Z",
    "credits_balance": 0,
    "lang": "es",
    "timezone": "America/Bogota"
}
```

{% endtab %}

{% tab title="400 Bad Request" %}

```json
{
    "message": "Invalid Input",
    "data": {
        "email": [
            "Este campo es requerido."
        ],
        "country": [
            "Este campo es requerido."
        ],
        "lang": [
            "Este campo es requerido."
        ],
        "company_name": [
            "Este campo es requerido."
        ]
    }
}
```

{% endtab %}

{% tab title="403 Forbidden – Token inválido" %}

```json
{
    "detail": "No tienes permisos para realizar esta acción."
}
```

{% endtab %}

{% tab title="403 Forbidden – Plan inválido" %}

```json
{
    "detail": "Plan necesario para crear empresa parceira."
}
```

{% endtab %}

{% tab title="403 Forbidden – Empresa es un socio" %}

```json
{
    "detail": "Acción no permitida para empresa parceira."
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Cada cuenta creada puede tener **su propia integración independiente** con la API de ZapSign, completamente separada de las demás.
{% endhint %}


---

# 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/re-sellers/crear-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.