---
title: "Use envelope"
method: POST
path: "/envelope/use"
tags: ["Envelope"]
---

# Use envelope

`POST /envelope/use`

Create a document envelope from a template envelope. Upload custom files to replace the template PDFs and map them to specific envelope items using identifiers.

## Response `200`

Successful response

- object
  - `id` string, required
  - `recipients` object[], required
    - `id` number, required
    - `name` string, required
    - `email` string, required
    - `token` string, required
    - `role` 'CC' | 'SIGNER' | 'VIEWER' | 'APPROVER' | 'ASSISTANT', required
    - `signingOrder` number, nullable, required
    - `signingUrl` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.net/documenso/apis/documenso-v2-api.md) · [All operations](https://skmtc.net/documenso/apis/documenso-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/documenso/documenso-v2-api/revisions/3db245102197/schema)