Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Disable In-Person Signer email notification to the host

Tags:

docusignapi

I'd like to know if it's possible to disable the email notification to a host when using In-Person signing. ( sent you a document to host for an in-person signing session.)

Repro:

1 - Envelope is created using API containing 3 recipients: One In-Person captive Signer and two remote signers.

2 - Host receives an email notification.

In-Person Sign Email Notification

JSON:

`{
   "status":"sent",
   "emailSubject":"Contract",
   "compositeTemplates":[
      {
         "serverTemplates":[
            {
               "sequence":"1",
               "templateId":"<templateId>"
            }
         ],
         "inlineTemplates":[
            {
               "sequence":"1",
               "recipients":{
                  "inPersonSigners":[
                     {
                        "hostEmail":"[email protected]",
                        "hostName":"John Doe",
                        "signerName":"Ringo Starr",
                        "signerEmail":"[email protected]",
                        "roleName":"Signer 1",
                        "recipientId":"1",
                        "clientUserId":"1000",
                        "routingOrder":"1",
                        "embeddedRecipientStartURL":"SIGN_AT_DOCUSIGN",
                        "recipientSignatureProviders":[
                           {
                              "signatureProviderName":"UniversalSignaturePen_OpenTrust_Hash_TSP",
                              "signatureProviderOptions":{
                                 "sms":"<phoneNumber>"
                              }
                           } 
                        ]
                  ],
                  "signers":[
                     {
                        "name":"John Doe",
                        "email":"[email protected]",
                        "emailNotification":{
                           "emailSubject":"Contract for live in person signature attached.",
                           "emailBody":"Contract for live in person signature attached.",
                           "supportedLanguage":"en"
                        },
                        "roleName":"Signer 2",
                        "routingOrder":"2",
                        "recipientId":"2",
                        "recipientSignatureProviders":[
                           {
                              "signatureProviderName":"UniversalSignaturePen_OpenTrust_Hash_TSP",
                              "signatureProviderOptions":{
                                 "sms":"<phoneNumber>"
                              }
                           }
                        ]
                     },
                     {
                        "name":"Paul McCartney",
                        "email":"[email protected]",
                        "emailNotification":{
                           "emailSubject":"Contract for live in person signature attached.",
                           "emailBody":"Contract for live in person signature attached.",
                           "supportedLanguage":"en"
                        },
                        "roleName":"Signer 3",
                        "routingOrder":"2",
                        "recipientId":"3",
                        "recipientSignatureProviders":[
                           {
                              "signatureProviderName":"UniversalSignaturePen_OpenTrust_Hash_TSP",
                              "signatureProviderOptions":{
                                 "sms":"<phoneNumber>"
                              }
                           }
                        ]
                     }
                  ]
               },
               "customFields":{
                  "textCustomFields":[
                     {
                        "value":"<salesforcecontractId>",
                        "required":"false",
                        "show":"false",
                        "name":"##SFContract"
                     }
                  ]
               }
            }
         ]
      }
   ],
   "eventNotification":{
      "RecipientEvents":[
         {
            "recipientEventStatusCode":"Completed"
         },
         {
            "recipientEventStatusCode":"sent"
         },
         {
            "recipientEventStatusCode":"delivered"
         },
         {
            "recipientEventStatusCode":"declined"
         }
      ],
      "EnvelopeEvents":[
         {
            "envelopeEventStatusCode":"Delivered"
         },
         {
            "envelopeEventStatusCode":"completed"
         },
         {
            "envelopeEventStatusCode":"sent"
         },
         {
            "envelopeEventStatusCode":"Declined"
         }
      ]
   }
}`

As I'm using an URL that can be accessed from my application the email notification to the host is unnecessary.

Considerations to keep in mind:

  1. None of the recipients neither the host is a DocuSign user;
  2. The option "Suppress emails to embedded signers" under Signing Settings is already checked;
  3. The host will not always be a recipient.

Regards.

like image 667
Zuinglio Jr. Avatar asked Nov 20 '25 01:11

Zuinglio Jr.


1 Answers

Remove "embeddedRecipientStartURL":"SIGN_AT_DOCUSIGN" from the inPerson recipient definition.

Specifying an embeddedRecipientStartURL causes the recipient to also receive an official DocuSign email inviting them to sign the documents. See this answer for more information.

From Official Documentation

embeddedRecipientStartURL is a sender provided valid URL string for redirecting an embedded recipient. When using this option, the embedded recipient still receives an email from DocuSign, just as a remote recipient would, but when the document link in the email is clicked the recipient is redirected, through DocuSign, to this URL to complete their actions. When routing to the URL, it is up to the sender's system (the server responding to the URL) to then request a recipient token to launch a signing session.

like image 111
Praveen Reddy Avatar answered Nov 22 '25 04:11

Praveen Reddy



Donate For Us

If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!