---
title: "Send Document"
method: POST
path: "/public/v1/documents/{id}/send"
tags: ["Documents"]
---

# Send Document

`POST /public/v1/documents/{id}/send`

> 🚧 Using the Sandbox Key
> 
> When you use a [sandbox API key](https://developers.pandadoc.com/reference/sandbox-key) during the free trial period, the sender and recipient email addresses must be from the same organisation (email domain).

## Document State

- You can only send a document in the `document.draft` status.
- After creating a new document, it usually retains a `document.uploaded` status for 3-5 seconds while the document syncs across PandaDoc servers. When the document is available for further API calls, it moves to the `document.draft` state. Use [Document Status](/reference/document-status) or [Webhooks](/reference/on-document-status-change) to check document status.
- Moving a document to the `document.sent` status finalizes the document structure, before recipients can complete it.
- If a template used for the document creation has an approval workflow turned on, the sent document moves to the `document.waiting_approval` status. Once the document is approved, you need to make the call again to move the document to `document.sent` status.

## Send and Silence Notifications

- By default, PandaDoc sends a notification email to the recipient, as well as notifications the sender has configured. You may disable all notifications for recipients by passing `silent: true`. This is useful when you are using alternative delivery methods such as linking to the document or embedding the document.
- The `silent: true` parameter disables sent, viewed, comment and completed document email notifications. "Document Approval" notification won't be affected by this parameter.
- If you pass `silent: false`, the document is going to be delivered by email and/or SMS. 

![Example email. Branding can be changed in workspace settings](https://files.readme.io/cc5a03e-email2.png)

## Select Approver from Group

If you have previously set up an approval workflow with selectable groups on the UI, you can select a particular approver from this group. Learn more about [selectable groups](https://support.pandadoc.com/en/articles/9714799-approval-workflow#h_01H4GNY5GSGG38BPYY46XV7GB4).  
To set an approver, we recommend to follow these steps:

1. Run the [Document Details](https://developers.pandadoc.com/reference/document-details) request.
2. Copy the `steps` part from the `approval_execution` section of the response into the `selected_approvers` field of the Send Document payload.
3. Modify your payload according to business needs: set `is_selected` to true for one approver.

> 📘 **Note**: You can change the selected approver only if you revert your document back to the `document.draft` status.

## Path parameters

- `id` string, required

## Request body

- DocumentSendRequest
  - `message` string — A message that will be sent by email with a link to a document to sign.
  - `subject` string — Value that will be used as the email subject.
  - `silent` boolean — If set to `true`, disables email notifications for document recipients and the document sender. Also disables scheduled reminders (manual reminders still possible). Doesn't affect "Approve document" email notification sent to the Approver.
  - `sender` object — You can set a sender of a document as an `email` or `membership_id`
    - `membership_id` string — Membership ID.
    - `email` string — Email.
  - `forwarding_settings` object — Set settings for Document and Signature forwarding.
    - `forwarding_allowed` boolean — Your recipient will be able/not able to forward the document to another email address.
    - `forwarding_with_reassigning_allowed` boolean — Your recipient will be able/not able to forward the right to fill out all fields (including signature) assigned to them to another email address.
  - `reply_to` string, email — Email address that will be used as a reply-to address for the document. To use this parameter, please contact the support team to have it enabled for your account.
  - `selected_approvers` object — Configuration for selected approvers.
    - `steps` object[] — Approval steps.
      - `id` string, required — Step ID.
      - `group` object, required — Group information.
        - `id` string, required — Group ID.
        - `type` string, required — Group type.
        - `assignees` object[], required — Assignees for the group.
          - `user` string — User ID.
          - `is_selected` boolean — Whether the user is selected.

## Response `200`

OK

- DocumentSendResponse
  - `id` string
  - `name` string
  - `status` string
  - `date_created` string
  - `date_modified` string
  - `date_completed` string, nullable — Document completion date.
  - `expiration_date` string
  - `version` string
  - `uuid` string
  - `recipients` object[]
    - `id` string
    - `first_name` string
    - `last_name` string
    - `recipient_type` 'signer' | 'CC' | 'approver'
    - `email` string, nullable
    - `phone` string, nullable
    - `delivery_methods` RecipientDeliveryMethods, nullable
      - `email` boolean
      - `sms` boolean
    - `signing_order` integer, nullable
    - `shared_link` string
    - `type` string, nullable

## Other responses

- `401` — Authentication error
- `403` — Permission error
- `404` — Not found
- `409` — Conflict
- `423` — Document is locked for editing
- `429` — Too Many Requests

---

[API](https://skmtc.net/pandadoc/apis/pandadoc-public-api.md) · [All operations](https://skmtc.net/pandadoc/apis/pandadoc-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandadoc/pandadoc-public-api/versions/0c2b70be3fb0/schema)