---
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`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/documents/{document_id}/send-reminder`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v1/documents/:document_id/send-reminder/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/pandadoc/apis/pandadoc-public-api.md) - [All operations](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/revisions/b9a306b1a421?raw)