---
title: "Adds one or more envelope attachments to a draft or in-process envelope."
method: PUT
path: "/v2.1/accounts/{accountId}/envelopes/{envelopeId}/attachments"
tags: ["EnvelopeAttachments"]
---

# Adds one or more envelope attachments to a draft or in-process envelope.

`PUT /v2.1/accounts/{accountId}/envelopes/{envelopeId}/attachments`

Adds one or more envelope attachments to a draft or in-process envelope.
Each envelope can have a maximum of 12 attachments.

Envelope attachments are files that an application can include in an envelope. They are not converted to PDF. Envelope attachments are available only through the API. There is no user interface in the Docusign web application for them.

For a list of supported file formats, see [Supported File Formats](https://support.docusign.com/s/document-item?bundleId=gbo1643332197980&topicId=xln1578456261162.html).

<!-- std notice DEVDOCS-114911 -->
<ds-inlinemessage kind="information" markdown="1">

It's easy to confuse envelope attachments,
which are developer-only files associated with an envelope,
with signer attachments.

To learn about the different types of attachments, see [Attachments](/docs/esign-rest-api/esign101/concepts/documents/attachments/) in the concept guide.

</ds-inlinemessage>
<!-- end notice DEVDOCS-114911 -->

## Path parameters

- `accountId` string, required
- `envelopeId` string, required

## Request body

- EnvelopeAttachmentsRequest
  - `attachments` Attachment[] — An object that contains information about the attachment.
    - `accessControl` string — Valid values are `sender` and `senderAndAllRecipients`.
    - `attachmentId` string — The unique identifier for the attachment.
    - `attachmentType` string — Specifies the type of the attachment for the recipient.
    - `data` string — A Base64-encoded representation of the attachment that is used to upload and download the file. File attachments may be up to 50 MB in size.
    - `label` string — A label for the attachment. Potential values include: - `guidedForm`: [Guided forms](https://www.docusign.com/products/guided-forms) provide a step-by-step, mobile-ready experience to help signers easily complete long or complex forms. - `eventNotifications`: A list of envelope-level event statuses that trigger Connect to send updates to the endpoint specified in the `url` property.
    - `name` string — The name of the attachment.
    - `remoteUrl` string — The URL of a previously staged chunked upload. Using a chunked upload enables you to stage a large, chunkable temp file. You then use the `remoteUrl` property to reference the chunked upload as the content in attachment and document-related requests. The `remoteUrl` property cannot be used for downloads.

## Response `200`

Successful response.

## Other responses

- `400` — Error encountered.

---

[API](https://skmtc.net/docusign/apis/docusign-esignature-rest-api.md) · [All operations](https://skmtc.net/docusign/apis/docusign-esignature-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docusign/docusign-esignature-rest-api/revisions/77f1998c313d/schema)