---
title: "How to Send a Manual Reminder to Sign a Document via API"
description: "This blog provides instructions on using the BoldSign API to send a manual reminder to sign an eSignature document, ensuring timely completion."
url: "https://boldsign.com/blogs/how-to-send-a-manual-reminder-to-sign-a-document-via-api/"
---

1. [Blog](https://boldsign.com/blogs.md)
2. [API](https://boldsign.com/category/api.md)

# How to Send a Manual Reminder to Sign a Document via API

[Gopinath Kannusamy](https://boldsign.com/author/gopinath-kannusamy/) June 24, 2024 Updated March 27, 2026 4 min read

Ensuring that all parties promptly sign documents maintains workflow efficiency and helps you meet deadlines. Sometimes, a gentle reminder is necessary to prompt signers to complete their part. Sending manual reminders via API lets you manage this process efficiently. This blog will guide you through the steps to send a manual reminder to sign a document using the BoldSign API.

## Importance of Manual Reminders

Manual reminders allow you to:

- **Control timing**: Send reminders at strategic times.
- **Target specific recipients:** Address signers who may require additional prompting.
- **Prompt action:** Encourage signers to complete their signatures promptly.
- **Avoid delays:** Help prevent workflow bottlenecks.
- **Maintain compliance:** Ensure timely execution of legally binding documents.

## When You Can Send Manual Reminders

Manual reminders can be sent only for documents that are in the Waiting or In Progress status. These reminders are sent only to signers who have not yet completed their action. Only one manual reminder per document per day is allowed. Sending a manual reminder does not affect any automatic reminder configuration.\
For more details, refer to the BoldSign guide on [sending reminders for waiting or in progress documents](https://developers.boldsign.com/how-to-guides/send-reminders-for-the-esignature-document).

## BoldSign API Overview

BoldSign provides a comprehensive API that includes functionalities for sending reminders to signers. The POST /v1/document/remind endpoint is specifically designed for this purpose, allowing you to send reminder emails to all pending signers of a document.

### Endpoint Details

| | |
| - | - |
| **Endpoint** | **\`POST /v1/document/remind\`** |
| Purpose | Sends a manual reminder email to the signers of a specified document. |
| Query Parameters | \`documentId\` (STRING, REQUIRED): The ID of the document for which the reminder should be sent. \`receiverEmails\` (ARRAY): Email address of the signer. Multiple email addresses can be specified if the document requires signatures from multiple signers. |
| Targeting recipients | If you include receiverEmails, the reminder targets only those signers; if you omit it, BoldSign sends the reminder to all pending signers for the document. |
| Request Body | \`message\` (STRING, REQUIRED): The message to be included in the reminder email. \`onBehalfOf\` (STRING, OPTIONAL): The email address of the sender if the document was sent on behalf of someone else. |
| Response behavior | On success, the endpoint returns HTTP 204 No Content. |

## Manual vs. Automatic Reminders

BoldSign supports both manual and automatic reminders to help ensure documents are signed on time. The key difference is how and when the reminders are sent. Manual reminders are sent on demand after the document is created. They are useful when you need to follow up at a specific time or remind selected signers who haven’t completed their action yet.

Automatic reminders are configured while creating the document. They run on a predefined schedule and require no manual intervention. Default automatic reminder settings can also be managed at the organization level, making them ideal for standard and recurring workflows. To learn more about setting up automatic reminders, refer to the BoldSign guide on [automatically reminding signers during document creation](https://developers.boldsign.com/how-to-guides/how-to-remind-the-signers-to-sign-the-document-automatically).

## Step-by-Step Guide to Sending Manual Reminders

### Step 1: Gather Required Information

BoldSign provides an API that allows you to programmatically send a manual reminder to recipients of a document by providing the following details:

**Document ID:** The ID of the document for which you want to send a reminder.

**Signer Email(s):** The email addresses of the signers who need to be reminded.

**Reminder Message:** A personalized message to include in the reminder email.

So, you need to have these ready.

You can retrieve signer email addresses and current document status using the [Document Properties](https://developers.boldsign.com/how-to-guides/retrieve-esignature-document-properties) API (**GET /v1/document/properties**) before calling the reminder endpoint.

### Step 2: Construct the API Request

Here’s how to construct the API request to send a manual reminder. Following are examples using different programming languages.

```
curl -X 'POST' \
  'https://api.boldsign.com/v1/document/remind?documentId={YOUR_DOCUMENT_ID}&receiverEmails={first.signer@example.com}&receiverEmails={second.signer@example.com}' \
  -H 'accept: */*' \
  -H 'X-API-KEY: {YOUR_API_KEY}' \
  -H 'Content-Type: application/json;odata.metadata=minimal;odata.streaming=true' \
  -d '{
  "message": "{Your message to the signers}"
}'
```

```
var apiClient = new ApiClient("https://api.boldsign.com", "{YOUR_API_KEY}");
var documentClient = new DocumentClient(apiClient);
documentClient.RemindDocument(
    documentId: "{YOUR_DOCUMENT_ID}",
    receiverEmails: new List<string> { "first.signer@example.com", "second.signer@example.com" },
    reminderMessage: new ReminderMessage(message: "Your message to the signers"));
```

```
import boldsign

configuration = boldsign.Configuration(api_key="YOUR_API_KEY")

with boldsign.ApiClient(configuration) as api_client:

    document_api = boldsign.DocumentApi(api_client)

    reminder_message = boldsign.ReminderMessage(message="Your message to the signers")

    document_api.remind_document(
        document_id="YOUR_DOCUMENT_ID",
        receiver_emails=["first.signer@example.com", "second.signer@example.com"],
        reminder_message=reminder_message,
    )
```

```
<?php require_once "vendor/autoload.php";

use BoldSign\Configuration;
use BoldSign\Api\DocumentApi;
use BoldSign\Model\ReminderMessage;

$config = new Configuration();
$config->setApiKey('YOUR_API_KEY');
$document_api = new DocumentApi($config);

$reminder_message = new ReminderMessage();
$reminder_message->setMessage('Your message to the signers');
$receiver_emails = [
    'first.signer@example.com',
    'second.signer@example.com'
];

$document_api->remindDocument($document_id = 'YOUR_DOCUMENT_ID',
    $receiver_emails, $reminder_message);
?>
```

```
ApiClient client = Configuration.getDefaultApiClient();
client.setApiKey("YOUR_API_KEY");

DocumentApi documentApi = new DocumentApi(client);

List receiverEmails = Arrays.asList("first.signer@example.com", "second.signer@example.com");
ReminderMessage reminderMessage = new ReminderMessage();
reminderMessage.setMessage("Your message to the signers");

documentApi.remindDocument("YOUR_DOCUMENT_ID", receiverEmails, reminderMessage);
```

```
import { DocumentApi, ReminderMessage } from "boldsign";

async function main() {
  const documentApi = new DocumentApi();
  documentApi.setApiKey("YOUR_API_KEY");

  const reminderMessage = new ReminderMessage();
  reminderMessage.message = "Your message to the signers";

  const receiverEmails = ["first.signer@example.com", "second.signer@example.com"];

  await documentApi.remindDocument("YOUR_DOCUMENT_ID", receiverEmails, reminderMessage);
}

main();
```

If you want to test the manual reminder API quickly without any manual setup, you can use the [Postman Send Reminder request](https://www.postman.com/boldsign/boldsign-s-public-workspace/request/fm0jk84/document-reminder?sideView=agentMode) available in the BoldSign Public Workspace.

## Conclusion

Sending manual reminders for eSignatures on documents helps ensure timely completion and maintain workflow efficiency. By following the steps outlined in this blog, you can effectively send manual reminders to your signers and keep your document signing process on track.

**Prefer using the BoldSign Web app?** Refer to the step‑by‑step guide on [sending manual reminders](https://support.boldsign.com/kb/article/93/send-manual-reminders-to-signer) directly from the BoldSign dashboard

If you’re not yet a customer, start a [30-day free trial](https://account.boldsign.com/signup?planId=1020\&utm_source=boldsignblogs\&utm_medium=redirect\&utm_campaign=boldsign) to try out BoldSign’s features. Please feel free to leave a comment below; your thoughts are much appreciated. If you have any questions or would like more information about our services, please [schedule a demo](https://boldsign.com/request-demo.md) or contact our support team via our [support portal](https://support.boldsign.com/support/tickets/create).

Topics [API integration](https://boldsign.com/blogs/tag/api-integration.md)[Signer experience](https://boldsign.com/blogs/tag/signer-experience.md)

## Sign documents 3x faster

Send, sign and manage documents securely and efficiently.

[Try it today](https://account.boldsign.com/signup?planId=1018\&utm_source=boldsignblogs\&utm_medium=redirect\&utm_campaign=boldsign)

## Gopinath Kannusamy

Gopinath is a passionate software developer with 2 years of experience at BoldSign. He is an avid writer and enjoys sharing his insights on technology and development. In his free time, he enjoys exploring new technologies and learning new things. Connect with him on [LinkedIn](https://www.linkedin.com/in/gopinath-kannusamy-b7b84517a/).

[More posts by Gopinath Kannusamy](https://boldsign.com/author/gopinath-kannusamy/)

## Related posts

- [API](https://boldsign.com/category/api.md) September 21, 2026 7 min read

  ## [How to Detect Email and SMS Delivery Failure in eSignature Code](https://boldsign.com/blogs/email-sms-delivery-failure-esignature-webhooks.md)

  Detect email and SMS delivery failure in eSignature workflows before it stalls a signature. Learn the root causes, and how to catch failures with webhooks.

- [API](https://boldsign.com/category/api.md) June 9, 2026 9 min read

  ## [Eliminate Approval Delays in Multi-Signer Workflows with Group Signers](https://boldsign.com/blogs/group-signers-api.md)

  Discover how BoldSign Group Signers help teams avoid approval delays by allowing any authorized member to securely sign documents via the API. Try now!

- [API](https://boldsign.com/category/api.md) May 12, 2026 5 min read

  ## [Group Signer in BoldSign: Secure Team-Based Signing with Directories](https://boldsign.com/blogs/group-signers-directory-rules.md)

  Learn how Group Signers enforce directory rules so only authorized teams can sign, blocking unauthorized access and keeping workflows secure and compliant.

Get started

## Sign up for your free trial today!

[Start free trial](https://account.boldsign.com/signup?planId=1018)

- 30-day free trial
- No credit card required

*Picture: A completed employment contract: signed by John Doe on 11/03/2026, all parties have signed*
