POST /api/v1/envelopes/bulk/initiate-and-invite — Envelope Creation & Signing Invitation Process
The API provides a complete end-to-end digital document signing workflow in a single operation. It initiates a signature envelope by accepting the document content as a Base64-encoded string, and immediately creates the envelope while generating a unique envelope ID. In the same process, the API also handles sending signing invitations to recipients. Each recipient receives a secure link via email or SMS, allowing them to review and sign the document electronically without requiring any additional API calls.
Authentication
SadqAuthorize
Request Headers
- Authorization (required)
- Bearer {token}
- Content-Type (required)
- application/json
Request Body
Content-Type: application/json
- referenceNumber (string, optional)
- Optional reference number for the envelope
- workflowId (GUID, optional)
- Workflow ID to apply predefined destinations
- isForExternalWorkFlow (string, optional)
- Flag for external workflow (sets workflowId to null)
- files (array, optional)
- Array of files to be signed
- destinations (array, optional)
- Array of recipients/signers
- SaveAsDraft (boolean, optional)
- Save Request As Draft
{
"Files": [
{
"File": "sadfsfsfr....",
"fileName": "PDF-File.pdf"
}
],
"Destinations": [
{
"DestinationName": "Nubani",
"DestinationEmail": "ahmed.alnubani@gmail.com",
"DestinationPhoneNumber": "",
"SigneOrder": 0,
"Signatories": [],
"AvailableTo": "2029-04-22T23:59:59Z",
"ConsentOnly": true,
"AuthenticationType": 0,
"AllowUserToSignAnyWhere": false,
"DailyNotify": false,
"Escalation": null
}
],
"SaveAsDraft": false
}Responses
HTTP 200 — Initial and Invite Successfully
{
"errorCode": 0,
"message": "Request initiated successfully",
"returnUrl": "/dashboard",
"stateValidationErrors": null,
"signature": "abc123securehash==",
"data": {
"envelopeId": "f3a1c2d4-5678-4e9a-b123-9f0e1d2c3b44",
"bulkFileResponse": [
{
"documentId": "a1b2c3d4-1111-2222-3333-444455556666",
"documentName": "contract.pdf",
"referenceNumber": "REF-2026-0001"
},
{
"documentId": "b2c3d4e5-7777-8888-9999-000011112222",
"documentName": "nda.pdf",
"referenceNumber": "REF-2026-0001"
}
],
"destinations": null,
"invitationSent": true
}
}HTTP 200 —
{
"errorCode": 100,
"message": "General Erorr",
"returnUrl": "/dashboard",
"stateValidationErrors": null,
"signature": "",
"data": null
}