Send Envelope for Signing
Send an envelope to all recipients for signing. Transitions the envelope from `draft` to `pending`. No request body is needed. Workflow settings (mode, verification, email notifications, redirect URL, etc.) are configured during envelope creation via `POST /envelopes`. Requirements: - At least one signer or approver recipient - PDF file must be uploaded - Sufficient credits
Send an envelope to all recipients for signing. Transitions the envelope from draft to pending.
No request body is needed. Workflow settings (mode, verification, email notifications, redirect URL, etc.) are configured during envelope creation via POST /envelopes.
Requirements:
- At least one signer or approver recipient
- PDF file must be uploaded
- Sufficient credits
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
curl -X POST "https://api.signsecure.com/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"
}
}{
"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"
}