# Actualizar firmante

## Actualizar firmante

<mark style="color:green;">`POST`</mark> `https://api.zapsign.com.br/api/v1/signers/{{signer_token}}/`

Actualiza información como el nombre, correo electrónico, método de autenticación, entre otros.&#x20;

{% hint style="info" %}
**Consejo**: puedes usar este endpoint para enviar recordatorios por correo o WhatsApp.  Se puede enviar un máximo de 1 recordatorio cada 30 minutos.&#x20;
{% endhint %}

#### 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</td><td>string</td><td>El nombre del firmante. </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 updated successfully" %}

```json
{
    "external_id": "",
    "sign_url": "https://app.zapsign.com.br/verificar/b5ade7f0-8bc2-463a-8475-d67eb7f58167",
    "token": "b5ade7f0-8bc2-463a-8475-d67eb7f58167",
    "status": "link-opened",
    "name": "Jane 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": 2,
    "last_view_at": "2023-07-06T05:34:37.776131Z",
    "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-10bdd195-46f9-4a20-b40e-9a07c41ec341?ctx=documentation>" %}