Send Envelope for Signing
Send an envelope to all recipients for signing. Normally transitions the envelope from `draft` to `pending`. When `workflow.estampEnabled` is true, returns `202`, transitions to `estamping`, and queues the provider e-stamp step; recipients are notified automatically after the stamped PDF is ready. No request body is needed. Workflow settings are configured during envelope creation via `POST /envelopes`. Requirements: - At least one signer or approver recipient - PDF file must be uploaded - Sufficient credits - A complete `estampConfig` when e-stamping is enabled
Send an envelope to all recipients for signing. Normally transitions the envelope from draft to pending. When workflow.estampEnabled is true, returns 202, transitions to estamping, and queues the provider e-stamp step; recipients are notified automatically after the stamped PDF is ready.
No request body is needed. Workflow settings are configured during envelope creation via POST /envelopes.
Requirements:
- At least one signer or approver recipient
- PDF file must be uploaded
- Sufficient credits
- A complete
estampConfigwhen e-stamping is enabled
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.
No request body is needed. Workflow settings are configured during envelope creation via POST /envelopes.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.signpad.signsecure.in/api/v1/envelopes/string/send" \ -H "Content-Type: application/json" \ -d '{}'{
"message": "string",
"envelopeId": "string",
"status": "pending",
"recipients": [
{
"id": "string",
"name": "string",
"email": "string",
"role": "string",
"order": 0,
"status": "string",
"actionUrl": "string"
}
],
"workflow": {
"mode": "string",
"verificationMethod": "string",
"message": "string",
"reminderEveryHours": 0,
"expiresAt": "2019-08-24T14:15:22Z",
"emailNotifications": "all",
"whatsappNotifications": "all"
}
}{
"success": true,
"estamp": true,
"estampStatus": "queued",
"message": "string",
"envelopeId": "string",
"status": "estamping"
}{
"code": "INVALID_STATUS",
"message": "Cannot send envelope. Envelope must be in draft status.",
"requestId": "req_abc123",
"timestamp": "2026-03-11T10:30:00.000Z"
}{
"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"
}