Trending Topics: Latest from our forums (October 2021)

Here are some of the latest popular questions that the Docusign developers community asked on Stack Overflow in the month of October 2021. You too can ask questions by using the tag docusignapi in Stack Overflow.

Thread: Is it guaranteed to get the latest signed document after receiving Docusign Event Notification 'Completed'?

Summary: The developer is trying to use Docusign Connect to receive notifications about complete documents. They then want to download the documents, but they find that sometimes the documents are not yet ready despite having received the webhook notification to their server.

Answer: The developer was using the RecipientEvents portion of the Connect notification. There are also EnvelopeEvents that can be used. The issue here may be that even if the last recipient completes the signing on their end, and this event is immediately fired to send a notification to the developer’s web server, the Docusign system is still processing the envelope. This is what we call a “race” condition where two things are happening at the same time and there’s no way to know which one will finish first. The envelope doesn’t change to completed status immediately when the last recipient finishes signing. There’s some backend work to secure the PDF and that takes additional time. The envelope event will be fired at that point, and listening to that event should, in most cases, resolve the issue. 

Furthermore, you can have the completed document as part of the connect event payload,, eliminating the need to make an API call to retrieve it and the possibility it will not be ready yet at that time.

Thread: custom Envelope EmailBlurb message text in better format like in Word document

Summary: This developer is asking about the EmailBlurb property that enables developers to set the body of the email message sent to recipients in an envelope. They would like to use rich text or HTML to customize the envelope.

Additionally, a limited set of HTML elements are supported in the EmailBlurb. These include <a> and <b> as well as others.

Answer: There are two ways to solve this problem. The first way is to use the Docusign Email Resources File. This file enables you to customize the account’s branding, including the emails that Docusign sends from this account to recipients. 

Thread: Docusign : How can I pause a docusign envelope created from template?

Summary: The developer is interested in using a template which includes advanced workflow capabilities to pause an envelope. They are getting an error trying to create an envelope from the template when it was set with a workflow step.

Answer: At the time of this writing, there’s a bug in the Docusign code preventing using advanced workflow to pause an envelope that was created from a template directly. You can still do that using a workaround that essentially decouples the workflow from the template. You can create the template without the workflow, create an envelope from the template, and then manually add the workflow to pause the envelope. You do the last stage (Assuming envelope is still in draft status) by calling the EnvelopeWorkflows:update method with this JSON:

  "workflowSteps": [
      "action": "pause_before",
      "triggerOnItem": "routing_order",
      "itemId": 2

Additional resources

Inbar Gazit
Inbar Gazit
Sr. Manager, Developer Content