Add Recipients
Add recipients to an envelope. Recipients can be signers, approvers, or CC. Each recipient needs a name plus at least one contact: an `email`, a `phone` (E.164, used for WhatsApp delivery), or both. WhatsApp messages are sent according to the envelope workflow's `whatsappNotifications` preference.
Add recipients to an envelope. Recipients can be signers, approvers, or CC.
Each recipient needs a name plus at least one contact: an email, a phone (E.164, used for WhatsApp delivery), or both. WhatsApp messages are sent according to the envelope workflow's whatsappNotifications preference.
Authorization
bearerAuth API key as Bearer token. Format: signsecure_xxxxxxxx...
In: header
Path Parameters
The envelope ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.signpad.signsecure.in/api/v1/envelopes/string/recipients" \ -H "Content-Type: application/json" \ -d '{ "recipients": [ { "name": "string" } ] }'{
"message": "string",
"recipients": [
{
"id": "string",
"name": "string",
"email": "string",
"phone": "string",
"role": "signer",
"order": 0,
"status": "pending",
"signatureMethod": "electronic"
}
]
}{
"code": "VALIDATION_ERROR",
"message": "recipients.0.email: Invalid email",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z",
"details": {
"validation": {
"fieldErrors": {
"recipients.0.email": [
"Invalid email"
]
},
"formErrors": [],
"issues": [
{
"path": "recipients.0.email",
"message": "Invalid email",
"code": "invalid_string"
}
]
}
}
}{
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z"
}{
"code": "FORBIDDEN",
"message": "API key is disabled",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z"
}{
"code": "NOT_FOUND",
"message": "Envelope not found",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z"
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "An internal error occurred",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z"
}