Recipients
Resend request
Resend the signing request email to a recipient who has not completed, as a reminder or after a soft bounce, within the documented wait periods.
Resends the signing request to a recipient who has not yet completed their ceremony.
Use this endpoint to:
- Send reminders. If a recipient has not signed, resend the invitation as a reminder.
- Retry after a soft bounce. If the invitation email was temporarily undeliverable, resend to try again.
- Re-deliver a lost email. If a recipient reports not receiving the invitation, resend it.
The resend is rate-limited to prevent email spam. The response includes can_resend_at, which tells you when the next resend can be initiated. The wait period after each email depends on how many have been sent so far, counting the first invitation:
| Emails sent | Wait before the next resend |
|---|---|
| 1-3 | 15 minutes |
| 4-6 | 1 hour |
| 7-9 | 24 hours |
| 10 | No more resends allowed |
A request sent before can_resend_at fails with too-early-to-resend, and a request after the tenth email fails with too-many-attempts. For reminders, space them at least 24 hours apart, and read can_resend_at from each response.
email_link authentication, the recipient’s status is sent or soft_bounced, and the envelope status is in_progress.Path Parameters
The unique identifier of the recipient. Recipient IDs use the re_ prefix.
Returns
Returns a 200 OK status code along with the following property:
Time after which the next resend can be initiated, in format.
Errors
| Status | Type | When |
|---|---|---|
404 | not-found | No recipient with this ID exists in the account and mode of your API key. |
409 | too-early-to-resend | The time in can_resend_at has not passed yet. The detail names the time. |
409 | too-many-attempts | Ten emails have already been sent to this recipient. |
409 | cannot-resend | The recipient has no active email_link ceremony, its status is not sent or soft_bounced, or the envelope is not in_progress. |
422 | validation-error | The request body is invalid. |
For errors every endpoint can return, such as authentication and rate limits, see Errors.
POST /v1/recipients/re_2f0wBwlt2te0kjU5QeL3Nl/resend HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEYnpx signatureapi recipients resend re_2f0wBwlt2te0kjU5QeL3Nl{
"name": "resend_request",
"arguments": {
"recipient_id": "re_2f0wBwlt2te0kjU5QeL3Nl"
}
}POST /v1/recipients/re_2f0wBwlt2te0kjU5QeL3Nl/resend HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
{
"subject_override": "Reminder: please sign your offer letter",
"message_override": "Your offer letter is ready for your signature."
}npx signatureapi recipients resend re_2f0wBwlt2te0kjU5QeL3Nl --subject 'Reminder: please sign your offer letter' --message 'Your offer letter is ready for your signature.'{
"name": "resend_request",
"arguments": {
"recipient_id": "re_2f0wBwlt2te0kjU5QeL3Nl",
"subject_override": "Reminder: please sign your offer letter",
"message_override": "Your offer letter is ready for your signature."
}
}{
"can_resend_at": "2026-11-02T17:42:12.000Z",
"subject_override": null,
"message_override": null
}{
"type": "https://signatureapi.com/docs/v1/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "The recipient was not found."
}{
"type": "https://signatureapi.com/docs/v1/errors/too-early-to-resend",
"title": "Too Early To Resend",
"status": 409,
"detail": "Please wait until after 2026-11-02T17:42:12.000Z to resend the request."
}{
"type": "https://signatureapi.com/docs/v1/errors/validation-error",
"title": "Validation Error",
"status": 422,
"detail": "The request body contains validation errors.",
"errors": [
"subject_override must be shorter than or equal to 500 characters"
]
}{
"can_resend_at": "2026-11-02T17:42:12.000Z",
"subject_override": "Reminder: please sign your offer letter",
"message_override": "Your offer letter is ready for your signature."
}Errors every call can return are in Errors and Authentication.