TL;DR: Add a reminderSettings object to your send request and set enableAutoReminder to true. Then choose the days between reminders and how many to send (up to 5). We then email the signer on that schedule until they sign. Our automated reminders page shows the same feature in the web app.
You send a contract from your app and then wait. The signer opened the email, meant to sign later and forgot. Without a reminder, someone on your team has to notice the delay and chase them by hand.
Automatic reminders do the chasing for you. This guide explains how they work in the BoldSign API, with code in six languages.
What are automatic reminders for eSignature requests?
Automatic reminders are follow-up emails that go to a signer who has not signed yet. You set the schedule once, and we send them for you.
Think of a dentist’s office that texts you before an appointment. You did nothing to ask for that text. The office set the rule once, and it runs for every patient.
Which signing tools include automatic reminders?
BoldSign includes automatic reminders in both the web app and the API. When you compare e-signature platforms, automated reminders are one feature to check.
Digital signatures software with automatic reminders saves you from tracking each request yourself. With the API, the schedule travels with the request, so your app needs no extra job to chase signers.
How do the BoldSign API reminder settings work?
You control reminders with a reminderSettings object in the send request. It holds three properties:
- enableAutoReminder turns automatic reminders on or off.
- reminderDays sets the number of days between each reminder.
- reminderCount sets how many reminders we send, up to 5.
Reminders go out at your chosen interval until the signer signs or the count runs out. The send document reference lists every field in the request.
How do you add automatic reminders with the BoldSign API?
Add the reminder settings to the same call that sends the document. You need an API key from your BoldSign account first.
- Build the request with your file, the signer and their form fields.
- Add reminderSettings with enableAutoReminder set to true.
- Set reminderDays to the gap you want, such as 2 days.
- Set reminderCount to the number of reminders, from 1 to 5.
- Send the request to the /v1/document/send endpoint.
Code samples in six languages
Each sample sends one document to one signer, Alex, with automatic reminders turned on. Pick your language from the tabs.
curl -X 'POST' \
'https://api.boldsign.com/v1/document/send' \
-H 'accept: application/json' \
-H 'X-API-KEY: {your API key}' \
-H 'Content-Type: multipart/form-data' \
-F 'ReminderSettings.ReminderDays={set days after which reminder should be sent}' \
-F 'ReminderSettings.ReminderCount={set the number of reminders to be sent}' \
-F 'Message={document message}' \
-F 'Signers={
"name": "Alex",
"emailAddress": "alex@example.com",
"signerType": "Signer",
"formFields": [
{
"id": "textbox1",
"name": "textbox1",
"filetype": "Textbox",
"pageNumber": 1,
"bounds": {
"x": 140,
"y": 140,
"width": 82,
"height": 32
},
"isRequired": true
}
]
}' \
-F 'Files=@{your file}' \
-F 'Title={title}' \
-F 'ReminderSettings.EnableAutoReminder=true'
var apiClient = new ApiClient("https://api.boldsign.com", "{Your API key}");
var documentClient = new DocumentClient(apiClient);
var documentFilePath = new DocumentFilePath
{
ContentType = "application/pdf",
FilePath = "{your file path}"
};
var filesToUpload = new List<IDocumentFile>
{
documentFilePath
};
var signatureField = new FormField(
id: "sign",
isRequired: true,
type: FieldType.Signature,
pageNumber: 1,
bounds: new Rectangle(x: 200, y: 200, width: 125, height: 25));
var formFieldCollections = new List<FormField>
{
signatureField
};
var signer = new DocumentSigner(
signerName: "Alex",
signerEmail: "alex@example.com",
signerType: SignerType.Signer,
formFields: formFieldCollections,
locale: Locales.EN);
var documentSigners = new List<DocumentSigner>
{
signer
};
var sendForSign = new SendForSign
{
Signers = documentSigners,
Title = "Auto Reminder",
ReminderSettings = new ReminderSettings
{
EnableAutoReminder = true,
ReminderCount = 3,
ReminderDays = 4
},
Files = filesToUpload
};
var response = documentClient.SendDocument(sendForSign);
import boldsign
configuration = boldsign.Configuration(host="https://api.boldsign.com", api_key="YOUR_API_KEY")
with boldsign.ApiClient(configuration) as api_client:
document_api = boldsign.DocumentApi(api_client)
form_field = boldsign.FormField(
fieldType="Signature",
pageNumber=1,
bounds=boldsign.Rectangle(x=50, y=50, width=200, height=25),
)
document_signer = boldsign.DocumentSigner(
name="Alex",
emailAddress="alex@example.com",
signerType="Signer",
formFields=[form_field],
)
send_for_sign = boldsign.SendForSign(
title="Document SDK API",
files=["YOUR_FILE_PATH"],
signers=[document_signer],
reminderSettings=boldsign.ReminderSettings(
enableAutoReminder=True, reminderDays=2, reminderCount=3
),
)
document_created = document_api.send_document(send_for_sign)
<?php
require_once "vendor/autoload.php";
use BoldSign\Configuration;
use BoldSign\Api\DocumentApi;
use BoldSign\Model\{FormField, Rectangle, DocumentSigner, SendForSign, FileInfo, ReminderSettings};
$config = new Configuration();
$config->setHost('https://api.boldsign.com');
$config->setApiKey('Your_BoldSign_API_Key');
$document_api = new DocumentApi($config);
$form_field = new FormField();
$form_field->setFieldType('Signature');
$form_field->setPageNumber(1);
$bounds = new Rectangle([100, 100, 100, 50]);
$form_field->setBounds($bounds);
$document_signer = new DocumentSigner();
$document_signer->setName("Alex");
$document_signer->setEmailAddress("alex@example.com");
$document_signer->setSignerType("Signer");
$document_signer->setFormFields([$form_field]);
// Reminder settings
$reminderSettings = new ReminderSettings();
$reminderSettings->setEnableAutoReminder(true);
$reminderSettings->setReminderDays(2);
$reminderSettings->setReminderCount(4);
$send_for_sign = new SendForSign();
$files = new FileInfo();
$files = 'Your_File.pdf';
$send_for_sign->setFiles([$files]);
$send_for_sign->setSigners([$document_signer]);
$send_for_sign->setTitle('Document SDK API');
$send_for_sign->setReminderSettings($reminderSettings);
$document_created = $document_api->sendDocument($send_for_sign);
ApiClient client = Configuration.getDefaultApiClient();
client.setBasePath("https://api.boldsign.com");
client.setApiKey("YOUR_BOLDSIGN_API_KEY");
DocumentApi documentApi = new DocumentApi(client);
FormField signatureField = new FormField();
signatureField.setFieldType(FormField.FieldTypeEnum.SIGNATURE);
signatureField.setPageNumber(1);
Rectangle bounds = new Rectangle().x(100f).y(100f).width(100f).height(50f);
signatureField.setBounds(bounds);
DocumentSigner signer = new DocumentSigner();
signer.setName("Alex");
signer.setEmailAddress("alex@example.com");
signer.setSignerType(DocumentSigner.SignerTypeEnum.SIGNER);
signer.setFormFields(Arrays.asList(signatureField));
ReminderSettings reminderSettings = new ReminderSettings();
reminderSettings.setEnableAutoReminder(true);
reminderSettings.setReminderDays(2);
reminderSettings.setReminderCount(3);
SendForSign sendForSign = new SendForSign();
File file = new File("Your_file_path.pdf");
sendForSign.setFiles(Arrays.asList(file));
sendForSign.setSigners(Arrays.asList(signer));
sendForSign.setTitle("Document SDK API");
sendForSign.setReminderSettings(reminderSettings);
DocumentCreated documentCreated = documentApi.sendDocument(sendForSign);
import {
DocumentApi,
DocumentSigner,
FormField,
Rectangle,
ReminderSettings,
SendForSign,
} from "boldsign";
import * as fs from "fs";
async function sendDocument() {
const documentApi = new DocumentApi("https://api.boldsign.com");
documentApi.setApiKey("YOUR_API_KEY");
const bounds = new Rectangle();
bounds.x = 100;
bounds.y = 50;
bounds.width = 100;
bounds.height = 100;
const formField = new FormField();
formField.fieldType = FormField.FieldTypeEnum.Signature;
formField.pageNumber = 1;
formField.bounds = bounds;
const documentSigner = new DocumentSigner();
documentSigner.name = "Alex";
documentSigner.emailAddress = "alex@example.com";
documentSigner.signerType = DocumentSigner.SignerTypeEnum.Signer;
documentSigner.formFields = [formField];
const files = fs.createReadStream("Employment contract.pdf");
const reminderSettings = new ReminderSettings();
reminderSettings.enableAutoReminder = true;
reminderSettings.reminderDays = 2;
reminderSettings.reminderCount = 3;
const sendForSign = new SendForSign();
sendForSign.title = "Agreement";
sendForSign.signers = [documentSigner];
sendForSign.files = [files];
sendForSign.reminderSettings = reminderSettings;
const documentCreated = await documentApi.sendDocument(sendForSign);
console.log(documentCreated.documentId);
}
sendDocument();
What should you watch out for with automatic reminders?
Set the schedule carefully before you send, since you cannot edit it later. Our help article on how to set automatic reminders through the API covers these rules.
- Reminder settings are fixed once the document is sent.
- We send no automatic reminders for an expired document.
- Documents expire after 60 days by default, so match reminderDays to that window.
A signer may still need a nudge outside the schedule. Our guide on how to send a manual reminder through the API shows that call.
How do you set up automatic reminders in the BoldSign web app?
You can set the same schedule without code when you send from the web app. The options sit in the Document settings section of a new document.
- Select Create New, then Create New Document.
- Add your files and recipients, then scroll to Document settings.
- Turn on the Auto reminder toggle.
- Enter the days between reminders in Remind every.
- Set the total number in Max. reminders, up to 5.
Which plan do you need, and what does the BoldSign API cost?
Live API calls need the Enterprise API plan, which starts at $30 a month with 40 envelopes. Each extra envelope costs $0.75, and prices are in USD.
You can build and test first in a free API sandbox account with no credit card. Sandbox documents carry a “This is a test document” watermark, and we delete them after 14 days.
Where do you go from here?
Try the reminder settings in your own code, then move to live sending when you are ready.
- Create a free API sandbox account and send your first reminder.
- Schedule a demo to see reminders and the rest of the API with our team.
- Ask a question through our support portal.
Frequently asked questions
How to automate signature reminders?
Turn on automatic reminders when you create the request. In the BoldSign API, set enableAutoReminder to true and pick reminderDays and reminderCount. In the web app, use the Auto reminder toggle.
How many automatic reminders can BoldSign send?
You can set up to 5 automatic reminders for each request. You choose the number with reminderCount in the API or Max. reminders in the web app.
Can I change reminder settings after I send a document?
No. You set automatic reminders when you create the document, and they stay fixed once it is sent. You can still send a manual reminder at any time.
Do reminders stop once the signer signs?
Yes. We send reminders on your schedule until the document is signed or the set number has gone out, whichever comes first.
What happens to reminders when a document expires?
They stop. We send no automatic reminders for an expired document. Documents expire after 60 days by default, and you can change that with expiryDays.
Can I send a reminder outside the automatic schedule?
Yes. A call to the /v1/document/remind endpoint emails the signer straight away. It works alongside any automatic schedule you set.
Can I test automatic reminders without paying?
Yes. A free API sandbox account needs no credit card. Sandbox documents carry a test watermark and are deleted after 14 days.
Are signatures collected after a reminder legally binding?
Yes, when the signing meets the usual rules for electronic signatures, such as the signer agreeing to sign electronically. A reminder only prompts the signer and does not change how the signature is made.