# Update signer

## Update signer

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

Update signer attributes like name, email and phone, or change their authentication mode, lock and unlock attributes. **This endpoint only works if signer has not signed the document.**

{% hint style="info" %}
**Tip**: You can use this endpoint to send reminders via email or WhatsApp. You can send a maximum of 1 reminder every 30 minutes.
{% endhint %}

#### Headers

<table><thead><tr><th width="148.0980224609375">Name</th><th width="102.78765869140625">Type</th><th>Description</th></tr></thead><tbody><tr><td>Authorization<mark style="color:red;">*</mark></td><td>string</td><td><p>apiToken ahead of the "Bearer" text. </p><p>Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23</p></td></tr></tbody></table>

#### Request Body

<table><thead><tr><th width="159.38421630859375">Name</th><th width="127.89556884765625">Type</th><th>Description</th></tr></thead><tbody><tr><td>redirect_link</td><td>string</td><td>Redirect link after signer signs. Remember to insert http:// or https:// at the beginning of the link. Default: "" </td></tr><tr><td>name</td><td>string</td><td>Signer fullname</td></tr><tr><td>email</td><td>string</td><td>Signer email</td></tr><tr><td>phone_country</td><td>string</td><td>Country code of the signer's phone (Ex: US is 1)</td></tr><tr><td>phone_number</td><td>string</td><td>Signer's phone (Ex: 11989118800)</td></tr><tr><td>auth_mode</td><td>string</td><td>You can choose the signer's authentication method. Possible values are: "assinaturaTela" (default) (signature on screen), "tokenEmail", "assinaturaTela-tokenEmail", "tokenSms" and "assinaturaTela-tokenSms". They correspond to the same methods available in the web interface.</td></tr><tr><td>lock_name</td><td>boolean</td><td>Block name change by signer.</td></tr><tr><td>lock_email</td><td>boolean</td><td>Block email change by signer.</td></tr><tr><td>lock_phone</td><td>boolean</td><td>Block phone change by signer.</td></tr><tr><td>qualification</td><td>string</td><td>How he will appear on the signature report. Ex: value "witness" will result in "Signed as a witness"</td></tr><tr><td>external_id</td><td>string</td><td>External ID of your app.</td></tr><tr><td>send_automatic_email</td><td>boolean</td><td> If true, ZapSign will send an email to the signer with the link to sign the document. If false (default), you will be responsible for sharing the subscription link with the signatory, whether through your website, widget, WhatsApp, SMS, email, chat etc. <br>Note: For this to work, it is mandatory that the signer's email address is defined. </td></tr><tr><td>send_automatic_whatsapp</td><td>boolean</td><td>If <strong>true</strong>, ZapSign will send a whatsapp message to the signer with the link to sign the document.<br><strong>Note:</strong> For this to work, it is mandatory that the signer's phone number is defined. <strong>each automatic sending via WhatsApp (tokenWhatsapp) costs 0,1 USD. Buy credits in</strong> <a href="https://app.zapsign.com.br/conta/configuracoes?tab=plans"><strong>Configuration > Plan</strong></a><strong>.</strong></td></tr><tr><td>send_automatic_whatsapp_signed_file</td><td>boolean</td><td>If <strong>true</strong>, ZapSign will send a whatsapp message to the signer with the link to the signed document.<br><strong>Note:</strong> For this to work, it is mandatory that the signer's phone number is defined. <strong>each automatic sending via WhatsApp (tokenWhatsapp) costs 0,1 USD. Buy credits in</strong> <a href="https://app.zapsign.com.br/conta/configuracoes?tab=plans"><strong>Configuration > Plan</strong></a><strong>.</strong></td></tr><tr><td>selfie_validation_type</td><td>String</td><td>Advanced biometric methods. The currently available options are: "liveness-document-match" and "identity-verification"</td></tr><tr><td>require_document_photo</td><td>Boolean</td><td>You can request that the signer takes a photo of their personal document while signing. Default:False</td></tr><tr><td>signature_placement</td><td>string</td><td>Allows positioning the signature in the document using anchor text (no x, y coordinates needed). Set signature_placement: "&#x3C;&#x3C;{signature_identifier}>>" and the signature will be positioned where this text is found. If the text appears more than once, the signature will be positioned at all locations. Note: using &#x3C;&#x3C; >> is highly recommended to avoid conflicts with text, but is not mandatory. Ex: "&#x3C;>". Default: ""</td></tr><tr><td>rubrica_placement</td><td>string</td><td>Allows positioning the rubrica in the document using anchor text (no x, y coordinates needed). Set rubrica_placement: "&#x3C;&#x3C;{rubrica_identifier}>>" and the rubrica will be positioned where this text is found. If the text appears more than once, the rubrica will be positioned at all locations. Note: using &#x3C;&#x3C; >> is highly recommended to avoid conflicts with text, but is not mandatory. Ex: "&#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>" %}