---
title: "Distribute envelope"
method: POST
path: "/envelope/distribute"
tags: ["Envelope"]
---

# Distribute envelope

`POST /envelope/distribute`

Send the envelope to recipients based on your distribution method

## Request body

- object
  - `envelopeId` string, required
  - `meta` object
    - `subject` string
    - `message` string
    - `timezone` string
    - `dateFormat` 'yyyy-MM-dd hh:mm a' | 'yyyy-MM-dd' | 'dd/MM/yyyy' | 'dd-MM-yyyy' | 'MM/dd/yyyy' | 'yy-MM-dd' | 'MMMM dd, yyyy' | 'EEEE, MMMM dd, yyyy' | 'dd/MM/yyyy hh:mm a' | 'dd/MM/yyyy HH:mm' | 'dd-MM-yyyy hh:mm a' | 'dd-MM-yyyy HH:mm' | 'MM/dd/yyyy hh:mm a' | 'MM/dd/yyyy HH:mm' | 'dd.MM.yyyy' | 'dd.MM.yyyy HH:mm' | 'yyyy-MM-dd HH:mm' | 'yy-MM-dd hh:mm a' | 'yy-MM-dd HH:mm' | 'yyyy-MM-dd HH:mm:ss' | 'MMMM dd, yyyy hh:mm a' | 'MMMM dd, yyyy HH:mm' | 'EEEE, MMMM dd, yyyy hh:mm a' | 'EEEE, MMMM dd, yyyy HH:mm' | 'yyyy-MM-dd'T'HH:mm:ss.SSSXXX'
    - `distributionMethod` 'EMAIL' | 'NONE'
    - `redirectUrl` string
    - `language` 'de' | 'en' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'pt-BR' | 'ja' | 'ko' | 'zh'
    - `emailId` string, nullable
    - `emailReplyTo` string, nullable
    - `emailSettings` object, nullable
      - `recipientSigningRequest` boolean
      - `recipientRemoved` boolean
      - `recipientSigned` boolean
      - `documentPending` boolean
      - `documentCompleted` boolean
      - `documentDeleted` boolean
      - `ownerDocumentCompleted` boolean
      - `ownerRecipientExpired` boolean
      - `ownerDocumentCreated` boolean

## Response `200`

Successful response

- object
  - `success` boolean, required
  - `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)