---
title: "Create an attachment request"
method: POST
path: "/e-signature-packages/{eSignaturePackageId}/signers/{signerId}/attachment-requests"
tags: ["Signers - Attachment Requests"]
---

# Create an attachment request

`POST /e-signature-packages/{eSignaturePackageId}/signers/{signerId}/attachment-requests`

Create an attachment request for for a signer. This operation is only valid when the eSignature package is in the `DRAFT`, `SENT`, `SCHEDULED`, `ACTIVE`, or `LIVE_EDITING` statuses. If the status is `SENT`, the signer should not have already SIGNED.

## Request body

- ESignatureSignerAttachmentRequest
  - `id` string
  - `name` string, required
  - `description` string
  - `isOptional` boolean — Set to true if the request is optional
  - `isConfidential` boolean — Set to true if the attachment should not be shared with other signers; only the owner

## Response `200`

Returns the object if it was successfully created.

- ESignatureSignerAttachmentRequest
  - `id` string
  - `name` string, required
  - `description` string
  - `isOptional` boolean — Set to true if the request is optional
  - `isConfidential` boolean — Set to true if the attachment should not be shared with other signers; only the owner

---

[API](https://skmtc.net/pactima/apis/esignature-packages-api.md) · [All operations](https://skmtc.net/pactima/apis/esignature-packages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pactima/esignature-packages-api/revisions/1570128383ef/schema)