+2I’m working with DocuSign Maestro Designer and need to get the value of a webform field/description that was filled in during a workflow run. Specifically, I want to retrieve the field values via the WorkflowInstanceManagement: getWorkflowInstance API.
Currently, I have access to:
accountId
workflowId
instanceId
But when I call getWorkflowInstance, I only see general instance metadata and status details. I don’t see how to extract the actual webform responses that were submitted.
+4Hello,
Looking at the API reference for Maestro, I don’t see any calls that currently return the webform field values. Here’s the reference for the WorkflowInstanceManagement specifically: https://developers.docusign.com/docs/maestro-api/reference/maestro/workflowinstancemanagement/getworkflowinstance/
I checked all of the API calls available and, unfortunately, couldn’t see any that return webform data at the moment. I would suggest creating an enhancement request for our engineering team to consider adding this: https://support.docusign.com/s/contactSupport?language=en_US
Best regards,
Jonathan | Docusign Developer Support
+2Thanks for the detailed feedback, appreciate you bringing this to our attention.
Could you please provide a specific example of the use case you are trying to solve by retrieving the webform field values? And what type of Workflow you building, types of steps?
+2Thanks for your response.
Our use case is that we need to capture applicant details entered in the Maestro webform (for example: applicant’s medical details, treatment options generated based on applicant assessment selections) and then consume those values outside of Maestro. Specifically, we want to use the getWorkflowInstance API to fetch those webform responses and pass them into our website so the applicant can see their submitted information right after the workflow step webform is completed and reloads the product web page.
The workflow we are building is primarily a data collection workflow. The steps currently include:
A webform step where the applicant enters their details.
An ID verification step.
An envelope signing step that requires signatures from specific personnel.
A completion step where the workflow instance ends.
One challenge we are facing is that after the ID verification step, the applicant returns back to the website before all required personnel sign the envelope. Since Maestro Workflow Designer does not provide a redirect URL option, we had to use email to bring the applicant back.
In this scenario, on the product details page (where the applicant initially clicked a button to start the DocuSign process), the applicant should be able to view certain input values — for example, total quantity and recommended medicines. These values are critical because our website needs to process them in order to calculate the exact payment amount accordingly.
If those webform field values would be in the getWorkflowInstance API response so we can reliably display them back on our website.
I have the exact same problem. Webforms is great, but if I can’t pull data from what my clients inputted on the web form, it’s not very useful to me.
I just wanted to quickly acknowledge that we’ve heard your need for having access to user-inputted data in Web Forms (and potentially other workflow steps) within your Maestro workflow instances. We are exploring options for adding this enhancement in the Maestro API roadmap. Unfortunately, I can’t provide or guarantee any timelines for when this might be available at this stage. However, we take your feedback seriously, and we appreciate you taking the time to share this info with us in the developer community forum. I hope you’ll continue to share any gaps/issues/bugs/needs that you discover with us so that we can identify ways to improve the usefulness and usability of our API and deliver greater value to you.
Steven | Docusign API Product Manager
Already have an account? Login
Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.
Back to Docusign.com
