Create envelope

Creates a new envelope containing one or more documents and associated signers. The envelope can be used for document signing or other related workflows. Upon creation, the envelope will be assigned a unique identifier for future operations such as tracking, signing, or editing. Ensure all required fields, including documents and signers, are provided in the request payload.

Request

Authorization

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Body Params application/json

Example

{
    "vaultId": "53504a12-1e16-4d58-9a32-07790b489382",
    "name": "Example Envelope",
    "privateDescription": "Private description of the envelope",
    "publicDescription": "Public description of the envelope",
    "message": "Message of the envelope",
    "reviewReminder": true,
    "expiresAtUtc": "2025-10-18T00:11:38.4053026Z",
    "expirationReminder": true,
    "toBePublishedAtUtc": "2025-09-19T00:11:38.4053033Z",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "signInOrder": true,
    "isAiChatForSignersEnabled": true,
    "signers": [
        {
            "name": "John Doe",
            "email": "john.doe@example.com",
            "allowEmailCommunication": false,
            "role": "Sign",
            "title": "Lawyer",
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceGeolocationValidation": true,
            "shouldAllowCustomDigitalCertificateValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "phoneIdd": 1,
            "phoneNumber": "5555555555",
            "allowPhoneSmsCommunication": false,
            "allowPhoneWhatsAppCommunication": false,
            "documentType": "GenericIdentification",
            "documentValue": "1234567890",
            "shouldEnforcePasscodeValidation": true,
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "signMarks": [
                {
                    "type": "Rubric",
                    "documentId": "50541128-b7f8-4c1c-a113-270e3bd8adf6",
                    "page": 1,
                    "x": 100,
                    "y": 50,
                    "rotation": 0
                },
                {
                    "type": "Signature",
                    "documentId": "50541128-b7f8-4c1c-a113-270e3bd8adf6",
                    "page": 2,
                    "x": 200,
                    "y": 50,
                    "rotation": 0
                }
            ]
        }
    ],
    "documents": [
        {
            "id": "50541128-b7f8-4c1c-a113-270e3bd8adf6",
            "name": "Example Document",
            "privateDescription": "Private description of the document",
            "publicDescription": "Public description of the document",
            "language": "EnUs",
            "markupOrientation": "Bottom"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.signater.com/v1/ecm/envelopes' \
--header 'x-api-token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "vaultId": "53504a12-1e16-4d58-9a32-07790b489382",
    "name": "Example Envelope",
    "privateDescription": "Private description of the envelope",
    "publicDescription": "Public description of the envelope",
    "message": "Message of the envelope",
    "reviewReminder": true,
    "expiresAtUtc": "2025-10-18T00:11:38.4053026Z",
    "expirationReminder": true,
    "toBePublishedAtUtc": "2025-09-19T00:11:38.4053033Z",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "signInOrder": true,
    "isAiChatForSignersEnabled": true,
    "signers": [
        {
            "name": "John Doe",
            "email": "john.doe@example.com",
            "allowEmailCommunication": false,
            "role": "Sign",
            "title": "Lawyer",
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceGeolocationValidation": true,
            "shouldAllowCustomDigitalCertificateValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "phoneIdd": 1,
            "phoneNumber": "5555555555",
            "allowPhoneSmsCommunication": false,
            "allowPhoneWhatsAppCommunication": false,
            "documentType": "GenericIdentification",
            "documentValue": "1234567890",
            "shouldEnforcePasscodeValidation": true,
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "signMarks": [
                {
                    "type": "Rubric",
                    "documentId": "50541128-b7f8-4c1c-a113-270e3bd8adf6",
                    "page": 1,
                    "x": 100,
                    "y": 50,
                    "rotation": 0
                },
                {
                    "type": "Signature",
                    "documentId": "50541128-b7f8-4c1c-a113-270e3bd8adf6",
                    "page": 2,
                    "x": 200,
                    "y": 50,
                    "rotation": 0
                }
            ]
        }
    ],
    "documents": [
        {
            "id": "50541128-b7f8-4c1c-a113-270e3bd8adf6",
            "name": "Example Document",
            "privateDescription": "Private description of the document",
            "publicDescription": "Public description of the document",
            "language": "EnUs",
            "markupOrientation": "Bottom"
        }
    ]
}'

Request

Request Code Samples

Responses