---
title: "Send Manual Reminder"
method: POST
path: "/public/v1/documents/{document_id}/send-reminder"
tags: ["Document Reminders"]
---

# Send Manual Reminder

`POST /public/v1/documents/{document_id}/send-reminder`

Sends manual reminders to one or more recipients of a specified document.

## Path parameters

- `document_id` string, required

## Request body

- DocumentSendManualReminderRequest
  - `reminders` object[] — A list of reminders to be sent to specified recipients. Use this field to specify which recipients should receive a reminder and through which delivery methods. Each email reminder contains document sender in the From field, ensuring the recipient always sees consistent sender details and branding.
    - `recipient_id` string — Unique identifier of the recipient to receive the reminder.
    - `delivery_methods` RecipientDeliveryMethods, nullable
      - `email` boolean
      - `sms` boolean
    - `email_customization` object — Optional customization settings for the reminder email. Defines the subject and body text used when sending the reminder via email. **This object is processed only if** `delivery_methods.email` is set to `true`.
      - `subject` string, nullable — Subject line of the reminder email sent to the recipient.
      - `message` string, nullable — Custom message body of the reminder email. Can include friendly or contextual text encouraging the recipient to complete the signing process. Supports **Markdown** syntax for rich text formatting (e.g., bold, italics, links, and line breaks).

## Response `200`

Successfully processed reminder requests.
Returns an array of objects, where each object details the outcome of the reminder delivery attempt for a specific recipient.

- DocumentSendManualReminder200Response
  - `result` object[]
    - `recipient_id` string — Unique identifier of the recipient.
    - `sms` object
      - `status` 'sent' | 'error' — Status of the SMS reminder attempt (sent or error).
      - `sent_at` string, date-time, nullable — Timestamp of when the reminder was sent, in ISO 8601 format. Present only on success.
      - `detail` 'Can't send reminder to CC recipient' | 'Can't send reminder to the Recipient who completed their part' | 'Can't send reminder. Signing order is enabled and this Recipient can't sign the document yet' | 'Can't send reminder. SMS delivery method is not selected for recipient' | 'Can't send SMS reminder to recipient group' | 'Can't send SMS reminder. Confirmation of recipient consent is required. Admin should access workspace settings to certify' | 'Can't send SMS reminder to the Recipient more than once every 24 hours' | 'Can't send SMS reminder to the Recipient with no phone number' | 'Can't send SMS reminder to the Recipient with invalid phone number' | 'Can't send reminder. The document does not contain a recipient with the specified recipient ID', nullable — Detailed explanation of why the reminder could not be sent. Present only on error.
    - `email` object
      - `status` 'sent' | 'error' — Status of the email reminder attempt (sent or error).
      - `sent_at` string, date-time, nullable — Timestamp of when the reminder was sent, in ISO 8601 format. Present only on success.
      - `detail` 'Can't send reminder to CC recipient' | 'Can't send reminder to the Recipient who completed their part' | 'Can't send reminder. Signing order is enabled and this Recipient can't sign the document yet' | 'Can't send reminder. Email delivery method is not selected for recipient' | 'Can't send email reminder. Recipient's mailbox is unreachable' | 'Can't send email reminder to the Recipient with no email' | 'Can't send email reminder to the Recipient more than once every 24 hours' | 'Can't send reminder. The document does not contain a recipient with the specified recipient ID' | 'Can’t send reminder. Email message contains potentially malicious links and could not be processed', nullable — Detailed explanation of why the reminder could not be sent. Present only on error.
    - `email_customization` object — Optional customization settings for the reminder email. Defines the subject and body text used when sending the reminder via email.
      - `subject` string, nullable — Subject line of the reminder email sent to the recipient.
      - `message` string, nullable — Custom message body of the reminder email. Can include friendly or contextual text encouraging the recipient to complete the signing process. Supports **Markdown** syntax for rich text formatting (e.g., bold, italics, links, and line breaks).

## Other responses

- `401` — Authentication error
- `403` — Permission error
- `404` — Not found
- `409` — Returned when a manual reminder cannot be sent due to the document's current status. This occurs when: - The document has not been sent yet. - The document is in a final state (e.g., completed, paid, declined, or expired). - The document is in "suggesting mode," during which reminders are disabled.
- `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)