An automatic recipient allows NSE to apply a signature or seal to a document without any human interaction. Instead of sending a signing link to a person, the signature step is executed automatically on the server side using a pre-configured sealing certificate.
- A sealing certificate is configured in Organization Settings → Sealing Certificates
- The
signatureProfilevalue must match the friendly name of the configured eSealing certificate exactly - The feature flag "AutomaticRemoteSignature" is enabled on the organization
- A valid JWT Bearer token or Personal Access Token
- Your organization ID (
organizationId) - A document ready to upload
POST /api/v1/organizations/{organizationId}/envelopes
Content-Type: application/json{
"name": "Automatic Signing Envelope",
"expiration": {
"expiresAt": "2026-12-31T23:59:59.000Z",
"mode": "absolute"
}
}Save the id from the response as envelopeId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files
Content-Type: multipart/form-datafile=@document.pdfSave the id from the response as fileId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages
Content-Type: application/json{
"name": "Automatic Seal",
"requiredRecipientCompletions": 1,
"type": "automatic"
}Save the id from the response as stageId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients
Content-Type: application/json{
"languageCode": "en",
"signatureProfile": "<profile-name>",
"type": "Automatic"
}Save the id from the response as recipientId.
POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks
Content-Type: application/json{
"tasks": [
{
"field": {
"fieldType": "AutomaticSignature",
"id": "1234",
"page": 1,
"positionX": 50,
"positionY": 200,
"width": 200,
"height": 60
},
"recipientId":"7117de33-1234-1234-1234-51809e7a3e20",
"sortOrder":1
}
]
}POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/sendThe stage executes immediately after sending. The seal is applied automatically and the envelope completes without any human interaction.
Once the envelope is completed, retrieve the artifacts via:
GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifactsThen download a specific artifact (signed document or audit trail) using its artifactId:
GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts/{artifactId}