Create envelope - Signater API

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": "1e3ef396-2fc2-4390-9194-0502b849fb56",
    "name": "Example Envelope",
    "privateDescription": "Private description of the envelope",
    "publicDescription": "Public description of the envelope",
    "message": "Message of the envelope",
    "reviewReminder": true,
    "expiresAtUtc": "2026-12-14T04:29:51.1389464Z",
    "expirationReminder": true,
    "toBePublishedAtUtc": "2026-11-15T04:29:51.1389468Z",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "signInOrder": true,
    "isAiChatForSignersEnabled": true,
    "isLtvEnabled": true,
    "redirectUrl": "https://example.com/callback",
    "sealId": "3b8f1c2e-5a10-4d7b-9e21-0c4a6f8d2b01",
    "signers": [
        {
            "name": "John Doe",
            "email": "john.doe@example.com",
            "emailCommunicationMode": "Full",
            "title": "Lawyer",
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "shouldEnforceSimpleSelfieValidation": true,
            "shouldEnforceVerifiedSelfieValidation": true,
            "shouldEnforceIdentityDocumentCapture": true,
            "shouldEnforceFaceMatch": true,
            "phoneIdd": 1,
            "phoneNumber": "5555555555",
            "smsCommunicationMode": "InvitationOnly",
            "whatsAppCommunicationMode": "InvitationOnly",
            "documentValue": "1234567890",
            "shouldEnforcePasscodeValidation": true,
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "signMarks": [
                {
                    "type": "Rubric",
                    "documentId": "40ca884f-eae8-4f3b-a691-058ae991d919",
                    "page": 1,
                    "x": 100,
                    "y": 50,
                    "rotation": 0,
                    "width": 0,
                    "height": 0,
                    "isRequired": true,
                    "schemaJson": null
                },
                {
                    "type": "Signature",
                    "documentId": "40ca884f-eae8-4f3b-a691-058ae991d919",
                    "page": 2,
                    "x": 200,
                    "y": 50,
                    "rotation": 0,
                    "width": 0,
                    "height": 0,
                    "isRequired": true,
                    "schemaJson": null
                }
            ]
        }
    ],
    "documents": [
        {
            "id": "40ca884f-eae8-4f3b-a691-058ae991d919",
            "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 'https://api.signater.com/v1/ecm/envelopes' \
--header 'x-api-token: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "vaultId": "1e3ef396-2fc2-4390-9194-0502b849fb56",
    "name": "Example Envelope",
    "privateDescription": "Private description of the envelope",
    "publicDescription": "Public description of the envelope",
    "message": "Message of the envelope",
    "reviewReminder": true,
    "expiresAtUtc": "2026-12-14T04:29:51.1389464Z",
    "expirationReminder": true,
    "toBePublishedAtUtc": "2026-11-15T04:29:51.1389468Z",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "signInOrder": true,
    "isAiChatForSignersEnabled": true,
    "isLtvEnabled": true,
    "redirectUrl": "https://example.com/callback",
    "sealId": "3b8f1c2e-5a10-4d7b-9e21-0c4a6f8d2b01",
    "signers": [
        {
            "name": "John Doe",
            "email": "john.doe@example.com",
            "emailCommunicationMode": "Full",
            "title": "Lawyer",
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "shouldEnforceSimpleSelfieValidation": true,
            "shouldEnforceVerifiedSelfieValidation": true,
            "shouldEnforceIdentityDocumentCapture": true,
            "shouldEnforceFaceMatch": true,
            "phoneIdd": 1,
            "phoneNumber": "5555555555",
            "smsCommunicationMode": "InvitationOnly",
            "whatsAppCommunicationMode": "InvitationOnly",
            "documentValue": "1234567890",
            "shouldEnforcePasscodeValidation": true,
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "signMarks": [
                {
                    "type": "Rubric",
                    "documentId": "40ca884f-eae8-4f3b-a691-058ae991d919",
                    "page": 1,
                    "x": 100,
                    "y": 50,
                    "rotation": 0,
                    "width": 0,
                    "height": 0,
                    "isRequired": true,
                    "schemaJson": null
                },
                {
                    "type": "Signature",
                    "documentId": "40ca884f-eae8-4f3b-a691-058ae991d919",
                    "page": 2,
                    "x": 200,
                    "y": 50,
                    "rotation": 0,
                    "width": 0,
                    "height": 0,
                    "isRequired": true,
                    "schemaJson": null
                }
            ]
        }
    ],
    "documents": [
        {
            "id": "40ca884f-eae8-4f3b-a691-058ae991d919",
            "name": "Example Document",
            "privateDescription": "Private description of the document",
            "publicDescription": "Public description of the document",
            "language": "EnUs",
            "markupOrientation": "Bottom"
        }
    ]
}'

Responses

🟢201Created

application/json

Envelope created successfully; the body is the envelope as GET /v1/ecm/envelopes/{envelopeId} answers it

Bodyapplication/json

Example

{
    "id": "3d70400a-0b09-46e2-a765-702056514199",
    "createdAtUtc": "2026-11-14T04:29:51.1391607Z",
    "createdById": "1cd53ca6-28ca-490e-ae56-016082fdfebe",
    "createdByName": "John Doe",
    "createdByAvatar": "https://example.com/avatar.jpg",
    "updatedAtUtc": "2026-11-14T04:29:51.1391614Z",
    "lastUpdateById": "a3b499e5-1e0e-4563-bfa7-6bad3270c328",
    "updatedByName": "John Doe",
    "updatedByAvatar": "https://example.com/avatar.jpg",
    "ownerId": "780c2190-d49e-4fe1-88fd-2d934d86ff46",
    "ownerName": "John Doe",
    "ownerAvatar": "https://example.com/avatar.jpg",
    "language": "EnUs",
    "markupOrientation": "Bottom",
    "status": "Published",
    "hasScheduledPublish": false,
    "toBePublishedAtUtc": null,
    "vaultId": "a0ca8743-fd62-4d1e-9b85-02f13a2202a9",
    "vaultName": "Example Vault",
    "name": "Example Envelope",
    "privateDescription": "Private description",
    "publicDescription": "Public description",
    "message": "Message",
    "reviewReminder": false,
    "expiresAtUtc": null,
    "expirationReminder": false,
    "isRemoved": false,
    "removedById": null,
    "removedBy": null,
    "removedAtUtc": null,
    "signInOrder": false,
    "certifiedAtUtc": null,
    "finalAtUtc": null,
    "isSandbox": false,
    "hasActionsBeingProcessed": false,
    "isAiChatForSignersEnabled": false,
    "isLtvEnabled": true,
    "redirectUrl": null,
    "seal": null,
    "documents": [
        {
            "id": "ec7146b5-85bc-4d5d-b3b6-8147cf12a974",
            "index": 0,
            "origin": "Upload",
            "name": "Example Document",
            "privateDescription": "Private description",
            "publicDescription": "Public description",
            "originalFileSize": 0,
            "originalFileSha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
            "signedFileSha256": null,
            "pageSizes": [
                {
                    "page": 1,
                    "width": 100,
                    "height": 100
                }
            ]
        }
    ],
    "accessPolicy": null,
    "signers": [
        {
            "id": "82763b0d-a70a-4de7-bbb7-aba36e39f88b",
            "index": null,
            "status": "ReadyToReview",
            "hadApproved": false,
            "approvedAtUtc": null,
            "hadRejected": false,
            "rejectedAtUtc": null,
            "name": "John Doe",
            "email": "john.doe@example.com",
            "title": "Title",
            "passcode": "123456",
            "passcodeHint": "1 to 6",
            "phoneIdd": 1,
            "phoneNumber": "123456789",
            "documentValue": "123456789",
            "shouldEnforceSmsValidation": true,
            "shouldEnforceWhatsAppValidation": true,
            "shouldEnforcePixValidation": true,
            "shouldEnforceCustomDigitalCertificateValidation": true,
            "shouldEnforcePasscodeValidation": true,
            "shouldEnforceEmailValidation": true,
            "shouldEnforceSimpleSelfieValidation": true,
            "shouldEnforceVerifiedSelfieValidation": true,
            "shouldEnforceIdentityDocumentCapture": true,
            "shouldEnforceFaceMatch": true,
            "emailCommunicationMode": "Full",
            "smsCommunicationMode": "InvitationOnly",
            "whatsAppCommunicationMode": "InvitationOnly",
            "signMarks": [
                {
                    "id": "0d8cd756-cb3a-412d-91d9-305d6507fa5f",
                    "documentId": "ec7146b5-85bc-4d5d-b3b6-8147cf12a974",
                    "type": "Signature",
                    "page": 1,
                    "x": 10,
                    "y": 10,
                    "rotation": 0,
                    "width": 0,
                    "height": 0,
                    "isRequired": false,
                    "schemaJson": null,
                    "valueJson": null,
                    "attachments": null
                }
            ],
            "actions": [
                {
                    "id": "52530e09-0d48-4b4c-a6cd-67ea5454c7e6",
                    "createdAtUtc": "2026-11-14T04:26:51.1391655Z",
                    "type": "View",
                    "ip": "127.0.0.1",
                    "userAgent": "Mozilla/5.0",
                    "location": "New York, USA",
                    "place": null,
                    "isBulkSession": false,
                    "signMarkId": null,
                    "signMarkType": null,
                    "signMarkSchemaJson": null,
                    "valueJson": null
                },
                {
                    "id": "80b694c1-1832-4dc8-bc5d-e1cf9a2bdc7e",
                    "createdAtUtc": "2026-11-14T04:26:51.1391662Z",
                    "type": "EmailMfaRequest",
                    "ip": "127.0.0.1",
                    "userAgent": "Mozilla/5.0",
                    "location": "New York, USA",
                    "place": null,
                    "isBulkSession": false,
                    "signMarkId": null,
                    "signMarkType": null,
                    "signMarkSchemaJson": null,
                    "valueJson": null
                }
            ]
        }
    ],
    "publishedAtUtc": null,
    "hasAnchors": false,
    "hasDigitalCertificateApproval": false,
    "actions": null
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠429