---
title: "Create Envelope"
method: POST
path: "/sign/envelopes"
tags: ["Sign"]
---

# Create Envelope

`POST /sign/envelopes`

The **Create Envelope** endpoint creates a new **sign envelope** in Nitro.

A **sign envelope** is the container for signature processes in Nitro. It can include assets such as documents, participants, signature fields, and configuration settings that define how the signing process should behave.
With the Create Envelope endpoint, you will create an empty sign envelope you can later add assets to.

## Request body

- EnvelopeCreate
  - `name` string, required — The Envelope's name. It doesn't have to be unique.
  - `notification` Notification, required
    - `subject` string, required — The subject line of the notification email.
    - `body` string, required — The body content of the notification email.
  - `mode` 'sequential' | 'parallel', required — The Signing Mode in an enum that defines the signing order. It has two possible values: - `sequential`: Participants receive notifications one at a time, in the order they were added to the envelope. Each new notification is triggered once the previous participant has completed their signing. - `parallel`: All participants are notified at the same time and can sign the documents in the envelope independently, without waiting for others.

## Response `201`

When an envelope is created you will get a unique ID for it. You can add assets to the envelope later by referencing its unique ID using other endpoints in this API.

- ExtendedEnvelope
  - `ID` string, uuid — A unique UUIDv4 string that identifies the envelope in the Nitro system.
  - `createdAt` string, date-time — UTC timestamp indicating when the envelope was created.
  - `lastModifiedAt` string, date-time — UTC timestamp indicating the last time the envelope was updated. Matches `createdAt` at the time of creation.
  - `name` string — The name of the envelope.
  - `status` 'drafted' | 'sent' | 'processing' | 'sealed' | 'rejected' | 'cancelled' | 'deleted' — The internal status of the envelope. Defaults to drafted on creation.
  - `mode` 'sequential' | 'parallel' — Signing mode for the envelope.
  - `notification` Notification
    - `subject` string, required — The subject line of the notification email.
    - `body` string, required — The body content of the notification email.

## Other responses

- `400` — Invalid envelope or document name
- `401` — Unauthorized - Invalid or missing JWT token

---

[API](https://skmtc.net/gonitro/apis/nitro-sign-public-api.md) · [All operations](https://skmtc.net/gonitro/apis/nitro-sign-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gonitro/nitro-sign-public-api/revisions/44cfae4dc99b/schema)