# Add attachment (extra document)

## Add extra document

<mark style="color:green;">`POST`</mark> `https://api.zapsign.com.br/api/v1/docs/{{original_doc_token}}/upload-extra-doc/`

This endpoint allows you to add attachments to your original document. Its possible to add up to 14 extra docs (one at a time, therefore, one request for each attachment), counting the original doc your signer will be able to sign 15 documents at once.

#### Headers

<table><thead><tr><th width="205">Name</th><th width="173">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="163">Name</th><th width="146">Type</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>string</td><td>Title of the document. String of up to 255 characters</td></tr><tr><td>url_pdf</td><td>string</td><td>Define the PDF to be signed from a public URL with the file. For now, we only accept one file in PDF format, up to 10Mb. </td></tr><tr><td>base64_pdf</td><td>string</td><td><p><strong>Alternative to url_pdf:</strong> Set the PDF to be signed, starting from a base64. You must convert the file to a base64 string and send it to us in this parameter (more details below).</p><p>Ex:</p><p>{</p><p>... 	"base64_pdf":"JVBERi0xLjcNCiWhs8XXDQoxIDA...",</p><p>}</p></td></tr></tbody></table>

{% tabs %}
{% tab title="200 Extra document successfully added." %}

```json
{
    "open_id": 17,
    // use this token in case you want to place signatures in this attachmentSSS
    "token": "50c7d90e-ead6-46b5-99d6-33d2d3b9a31f", 
    "name": "Anexo ao Contrato de Admissão João",
    "original_file": "https://zapsign.s3.amazonaws.com/aaa/48025712-b429-4216-8a33-d90c575d0b7f/0e2d0a87-a0f6-4a49-a05f-7a439fd7308e.pdf",
    "signed_file": null
},
```

{% endtab %}
{% endtabs %}

There is no other parameter to be sent in this request because they will be inherited from the original document.

{% hint style="info" %}
**Obs:** dont mistake the extra document with [the batch sign via API](https://docs.zapsign.com.br/english/signatarios/assinar-em-lote-via-api), because this one is made to sign multiple documents at the same time not to create attachments. They have different use cases.
{% endhint %}

### Request

{% embed url="<https://www.postman.com/zapsign/workspace/zapsign-workspace/request/27495556-b41b0068-b7e4-47aa-a828-e65084fcdb4b?ctx=documentation>" %}

### Response

{% hint style="warning" %}
**Caution:** the **original\_file** and **signed\_file** links are temporary and **expires in 60 minutes**. In case your system needs to save those links it is recommended that you save them in your own CDN or that you call the [Detail document](https://docs.zapsign.com.br/english/documentos/detalhar-documento) endpoint every time your user needs a valid URL that will expires in more 60 minutes.
{% endhint %}

```json
{
    "open_id": 17,
    // use this token in case you want to place signatures in this attachment
    "token": "50c7d90e-ead6-46b5-99d6-33d2d3b9a31f", 
    "name": "Anexo ao Contrato de Admissão João",
    "original_file": "https://zapsign.s3.amazonaws.com/aaa/48025712-b429-4216-8a33-d90c575d0b7f/0e2d0a87-a0f6-4a49-a05f-7a439fd7308e.pdf",
    "signed_file": null
},
```

### Frequently asked questions

#### Whats an attachment/extra document?

In case you use our web platform, you will notice that is possible to upload multiple PDFs at once to be signed by the same signers:

<figure><img src="https://1401277393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-1703796690%2Fuploads%2FbddPuTNzqQJ85Khnf5Ku%2Fimage.png?alt=media&#x26;token=edaeb690-a054-484b-b5be-779b74d8199d" alt=""><figcaption><p>Example of the web application with 3 PDFs in one envelope.</p></figcaption></figure>

That way, when the signer is going to sign the document, she will be see all of them, to sign at once:

<figure><img src="https://1401277393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-1703796690%2Fuploads%2FatNShmhge6tXN2PrcZEt%2Fimage.png?alt=media&#x26;token=afc86e06-9ab7-4f21-96c6-f361a579162f" alt=""><figcaption></figcaption></figure>

**The original document will be the number 1** and the **attachments will appear to the signer as the documents number 2,3, etc**. Doing a GET request on the original document, the attachments will be on the **"extra\_docs"** paramenter.

**Can i place signatures on an attachment?**\
Yes! Just send yout attachment token on the [endpoint for placing signatures](https://docs.zapsign.com.br/english/documentos/opcional-posicionar-assinaturas)

**I've added attachment by mistake. Can i delete it?**\
No. For now, it's impossible to remove attachments after added. You can [delete de document](https://docs.zapsign.com.br/english/documentos/excluir-documento) and [re-create it](https://docs.zapsign.com.br/english/documentos/criar-documento).