{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Automatic Recipient Workflow","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"automatic-recipient-workflow","__idx":0},"children":["Automatic Recipient Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A sealing certificate is configured in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization Settings → Sealing Certificates"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signatureProfile"]}," value must match the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["friendly name"]}," of the configured eSealing certificate exactly"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The feature flag ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"AutomaticRemoteSignature\""]}," is enabled on the organization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JWT Bearer token"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personal Access Token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["organization ID"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A document ready to upload"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-walkthrough","__idx":2},"children":["API walkthrough"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1--create-the-envelope","__idx":3},"children":["Step 1 — Create the envelope"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Automatic Signing Envelope\",\n  \"expiration\": {\n    \"expiresAt\": \"2026-12-31T23:59:59.000Z\",\n    \"mode\": \"absolute\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," from the response as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2--upload-the-document","__idx":4},"children":["Step 2 — Upload the document"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files\nContent-Type: multipart/form-data\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"file=@document.pdf\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," from the response as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3--create-the-stage","__idx":5},"children":["Step 3 — Create the stage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"name\": \"Automatic Seal\",\n  \"requiredRecipientCompletions\": 1,\n  \"type\": \"automatic\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," from the response as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["stageId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4--add-the-automatic-recipient","__idx":6},"children":["Step 4 — Add the automatic recipient"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/stages/{stageId}/recipients\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"languageCode\": \"en\",\n    \"signatureProfile\": \"<profile-name>\",\n    \"type\": \"Automatic\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," from the response as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientId"]}]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5--add-the-signature-task","__idx":7},"children":["Step 5 — Add the signature task"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tasks\": [\n    {\n      \"field\": {\n        \"fieldType\": \"AutomaticSignature\",\n        \"id\": \"1234\",\n        \"page\": 1,\n        \"positionX\": 50,\n        \"positionY\": 200,\n        \"width\": 200,\n        \"height\": 60\n      },\n      \"recipientId\":\"7117de33-1234-1234-1234-51809e7a3e20\",\n      \"sortOrder\":1\n    }\n  ]  \n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-6--send-the-envelope","__idx":8},"children":["Step 6 — Send the envelope"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/send\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The stage executes immediately after sending. The seal is applied automatically and the envelope completes without any human interaction."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"downloading-the-signed-documents","__idx":9},"children":["Downloading the signed documents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the envelope is completed, retrieve the artifacts via:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Then download a specific artifact (signed document or audit trail) using its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["artifactId"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/artifacts/{artifactId}\n","lang":"http"},"children":[]}]},"headings":[{"value":"Automatic Recipient Workflow","id":"automatic-recipient-workflow","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"API walkthrough","id":"api-walkthrough","depth":2},{"value":"Step 1 — Create the envelope","id":"step-1--create-the-envelope","depth":3},{"value":"Step 2 — Upload the document","id":"step-2--upload-the-document","depth":3},{"value":"Step 3 — Create the stage","id":"step-3--create-the-stage","depth":3},{"value":"Step 4 — Add the automatic recipient","id":"step-4--add-the-automatic-recipient","depth":3},{"value":"Step 5 — Add the signature task","id":"step-5--add-the-signature-task","depth":3},{"value":"Step 6 — Send the envelope","id":"step-6--send-the-envelope","depth":3},{"value":"Downloading the signed documents","id":"downloading-the-signed-documents","depth":2}],"frontmatter":{"seo":{"title":"Automatic Recipient Workflow"}},"lastModified":"2026-08-06T13:15:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/automatic-recipient-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}