# Adicionar firmante

## Adicionar firmante

<mark style="color:green;">`POST`</mark> `https://api.zapsign.com.br/api/v1/docs/{{doc_token}}/add-signer/`

Add a signer to a document.

#### Encabezado

<table><thead><tr><th width="175">Nombre</th><th width="103">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="173">Nombre</th><th width="126">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td>name<mark style="color:red;">*</mark></td><td>string</td><td>El nombre del firmante. Obligatorio</td></tr><tr><td>email</td><td>string</td><td>Correo electrónico del firmante</td></tr><tr><td>phone_country</td><td>string</td><td>El código de país del teléfono del firmante.</td></tr><tr><td>phone_number</td><td>string</td><td>El número de teléfono del firmante. Ejemplo: "11998989222".</td></tr><tr><td><strong>require_document</strong></td><td>boolean</td><td>Si es true, se requerirá que el firmante proporcione su información de identificación (país, tipo de documento y número de documento). Esta información se incluirá en el informe de firma. Valor predeterminado: false.</td></tr><tr><td><strong>require_document_data</strong></td><td>objeto</td><td><p>Si se definen el país, tipo de documento y número de documento, el firmante no podrá modificar esta información durante el proceso de firma. Si solo se definen el país y el tipo de documento, el firmante deberá ingresar el número</p><ul><li><strong>document_country</strong> (string). Posibles valores: "br" (Brazil), "co" (Colombia), "mx" (Mexico), "us" (United Stated), "ar" (Argentina), "pe" (Peru), "cl" (Chile), "other" (Other country).</li><li><strong>document_type</strong> (string). Posibles valores: "national_id", "foreign_id", "driver_license", "ppt".</li><li><strong>document_number</strong> (string): Por defecto: "".</li></ul></td></tr><tr><td>auth_mode</td><td>string</td><td>Elige el método de autenticación para el firmante. Esto adiciona más seguridad al documento firmado, para conocer los posibles valores <a href="../documentos/criar-documento">haz clic aqui</a></td></tr><tr><td>lock_name</td><td>boolean</td><td>Si se establece en true, el firmante no podrá cambiar su nombre durante el proceso de firma</td></tr><tr><td>lock_email</td><td>boolean</td><td>Si se establece en true, el firmante no podrá cambiar su correo electrónico durante el proceso de firma</td></tr><tr><td>lock_phone</td><td>boolean</td><td>Si se establece en true, el firmante no podrá cambiar su celular durante el proceso de firma</td></tr><tr><td>qualification</td><td>string</td><td>Rol del firmante que se mostrará en el informe de firma. Por ejemplo "Testigo" se mostrará como "Firmo como Testigo".</td></tr><tr><td>external_id</td><td>string</td><td>ID del firmante en tu aplicación.</td></tr><tr><td>send_automatic_email</td><td>boolean</td><td> Si se establece en true, ZapSign enviará automáticamente un correo al firmante con el enlace para firmar el documento. Enviará un recordatorio para firmar el documento.</td></tr><tr><td>send_automatic_whatsapp</td><td>boolean</td><td><p> Si se establece en true, ZapSign enviará automáticamente un WhatsApp al firmante con el enlace para firmar el documento. Enviará un recordatorio para firmar el documento. </p><p>Recuerda que se deben tener créditos para enviar por WhatsApp</p></td></tr><tr><td>redirect_link</td><td>string</td><td>Enlace al que se redirige al firmante después de firmar el documento. Después de firmar se mostrará un botón de "Continuar". Recuerda incluir http:// o https:// al inicio del enlace</td></tr><tr><td>send_automatic_whatsapp_signed_file</td><td>boolean</td><td>Si se establece en <strong>true</strong>, ZapSign enviará un mensaje por WhatsApp al firmante con el enlace al documento firmado. Recuerda que se deben tener créditos para enviar por WhatsApp.</td></tr><tr><td>selfie_validation_type</td><td>String</td><td><p>Métodos avanzados de biometría para identificar al firmante: </p><p>"liveness-document-match": Reconocimiento facial que valida que el firmante esté presente y sea el mismo que la foto del documento suministrada.</p><p>"identity-verification": Validación del documento y biometría facial, asegurando que el firmante esté presente, que el documento sea real y que esté registrado en bases de datos gubernamentales.</p></td></tr><tr><td>require_document_photo</td><td>Boolean</td><td>Si se establece en true, se pedirá al firmante que tome una foto del frente y anverso del documento de identidad durante el proceso de firma (no hay validación de la foto).</td></tr><tr><td><br>require_selfie_photo</td><td>Boolean</td><td>Si se establece en true, se pedirá al firmante que tome una selfie durante el proceso de firma (no hay validación de la foto). Por defecto es false.</td></tr><tr><td>signature_placement</td><td>string</td><td>Permite posicionar la firma en el documento usando un texto ancla (sin necesidad de coordenadas x, y). Configure signature_placement: "&#x3C;&#x3C;{identificador_de_firma}>>" y la firma será posicionada donde encuentre ese texto. Si el texto aparece más de una vez, la firma será posicionada en todas las ubicaciones. Nota: el uso de &#x3C;&#x3C; >> es altamente recomendado para evitar conflictos con el texto, pero no es obligatorio. Ej: "&#x3C;>". Default: ""</td></tr><tr><td>rubrica_placement</td><td>string</td><td>Permite posicionar la rúbrica en el documento usando un texto ancla (sin necesidad de coordenadas x, y). Configure rubrica_placement: "&#x3C;&#x3C;{identificador_de_rubrica}>>" y la rúbrica será posicionada donde encuentre ese texto. Si el texto aparece más de una vez, la rúbrica será posicionada en todas las ubicaciones. Nota: el uso de &#x3C;&#x3C; >> es altamente recomendado para evitar conflictos con el texto, pero no es obligatorio. Ej: "&#x3C;>". Default: ""</td></tr></tbody></table>

{% tabs %}
{% tab title="200 Signer added successfully" %}

```json
{
    "external_id": "",
    "sign_url": "https://app.zapsign.com.br/verificar/b5ade7f0-8bc2-463a-8475-d67eb7f58167",
    "token": "b5ade7f0-8bc2-463a-8475-d67eb7f58167",
    "status": "new",
    "name": "John Doe",
    "lock_name": false,
    "email": "",
    "lock_email": false,
    "hide_email": false,
    "blank_email": false,
    "phone_country": "55",
    "phone_number": "",
    "lock_phone": false,
    "hide_phone": false,
    "blank_phone": false,
    "times_viewed": 0,
    "last_view_at": null,
    "signed_at": null,
    "auth_mode": "assinaturaTela",
    "qualification": "",
    "require_selfie_photo": false,
    "require_document_photo": false,
    "geo_latitude": null,
    "geo_longitude": null,
    "redirect_link": "",
    "signature_image": null,
    "visto_image": null,
    "document_photo_url": "",
    "document_verse_photo_url": "",
    "selfie_photo_url": "",
    "selfie_photo_url2": "",
    "send_via": "email"
}

```

{% endtab %}
{% endtabs %}

### Request

{% embed url="<https://www.postman.com/zapsign/workspace/zapsign-workspace/request/27495556-666b0c30-6fe7-4870-aa2e-160d3252169d?ctx=documentation>" %}


---

# 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/firmantes/adicionar-signatario.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.