NetDocuments wins the case for their customers by integrating with the DocuSign eSignature REST API

NetDocuments logo

“Lawyers want a seamless workflow that connects drafting, executing, and saving signed agreements back into the client file. NetDocuments’ integration with DocuSign makes that possible. ” — Dan Hauck, Chief Product Officer, NetDocuments

NetDocuments, a DocuSign Partner, offers a cloud-first legal content management service. Among other products, the platform provides a repository for customers to store, manage, and collaborate on legal documents. Thousands of law firms and corporate legal departments around the world trust NetDocuments to secure their documents, emails, and more.

The case for DocuSign

Before developing the integration, NetDocuments knew that eSignature functionality was a key next step for their product. Signatures are often essential for legal documents such as contracts, agreements, engagement letters, and more. In fact, many NetDocuments customers were already using DocuSign even before it was integrated into the platform. For example, a lawyer using NetDocuments might have a contract that needed to be signed by a third party. The lawyer would download the document from NetDocuments, upload it to DocuSign, send it for signing, download the executed document, and re-upload it to NetDocuments. This process was not only cumbersome. Requiring the lawyer to download the document also contradicted one of NetDocuments’ key value propositions: to ensure security and best governance practices, the journey of a document should be cloud-first.

When the NetDocuments team decided to implement eSignature capabilities into the platform, they looked at several different options. DocuSign was the clear choice. Besides being the leading eSignature platform, DocuSign was already used and trusted by NetDocuments customers. As product manager Fred Levesque explained, “Even in January of 2020 when we were just shopping this around with customers, it was just such a strong reaction and clear value-add on both sides.”

Raising the bar

The NetDocuments document management platform is organized hierarchically. Each client’s repository is divided into categories called workspaces, which contain various matters. A matter represents a single project, such as a transaction or contract negotiation, and contains multiple documents. Customers can enable the DocuSign integration at the workspace level.

To enable users to interact with DocuSign within NetDocuments, the engineering team implemented DocuSign’s embedded signing model. From any matter that has the DocuSign integration enabled, users enter the document view, right-click a document, and choose Send to DocuSign (see Figure 1). Users are then prompted to log in to DocuSign. To implement OAuth, NetDocuments chose Authorization Code Grant workflow. The application requests an authorization code and then an access token and base URI. With those, the integration can make DocuSign API calls on behalf of the user.

Initiating the DocuSign flow within NetDocuments

Figure 1: Initiating the DocuSign flow within NetDocuments

After logging in, the user is prompted to add a recipient, subject, and message in a modal dialog box built by the NetDocuments engineering team (see Figure 2). Once the user selects Submit, the application calls the DocuSign createEnvelope API endpoint with the document and recipient information to create the envelope. This endpoint returns an envelopeId. The application uses this identifier to call the createSender endpoint and retrieve a URL to embed the DocuSign web app within the NetDocuments application. From there, the user can add tabs, modify recipient roles, and so on. Finally, when the user selects Send, they are redirected to their workspace.

Adding recipients and a message for the envelope within the NetDocuments integration

Figure 2: Adding recipients and a message for the envelope within the NetDocuments integration

Since users are directed from NetDocuments to the native DocuSign UI, they can take advantage of a wide variety of powerful DocuSign features—without any extra technical development required. For example (and of particular interest to law firms), a NetDocuments user might want to send a document to a client for notarized signing. In this case, the user can take advantage of DocuSign’s Remote Online Notarization (RON) feature. RON enables senders to add notary groups, which match a signer and notary who remotely notarizes the document. When the user clicks Submit in NetDocuments and is redirected to DocuSign, they can simply add a notary group to their envelope.

Within the NetDocuments repository, users can also view the status of their sent documents (see Figure 3). When viewing all the documents, those that have been sent via DocuSign are marked with a Sent via DocuSign icon. Users can select a given document and view the eSignature tab to see the recipients and their status (such as needs to sign or completed). Once the document has been completed, it is received by NetDocuments and is added to the repository as a signed version.

Recipient status view`

Figure 3: Recipient status view

The NetDocuments engineering team implemented these status checks with DocuSign Connect, a webhook service that provides real-time envelope status notifications. With Connect, the integration does not have to poll DocuSign continuously to find out if documents have been signed. Instead, the developers used Connect to receive event notifications for changes in the envelope status (like envelope-completed or envelope-voided) and relevant recipient events (like recipient-sent or recipient-delivered). Connect notifies the integration when these events occur so the internal app state can be updated and displayed to the user as necessary.

Putting the plan into motion

In March 2021, NetDocuments officially began product development. The engineers chose to use Angular for the front end and NestJS for the back end. By September, they had developed the integration, run a closed beta, and released v1 to their customers. Throughout the development process, the DocuSign Global Partner Solutions team provided customized guidance and advice about best practices.

The product team began by developing a prototype and presenting it to customers. Based on their feedback, the engineers built an integration that was released as a closed beta. 

Additional feedback enabled the team to continually iterate and improve. The integration also went through penetration testing to ensure that it was highly secure. Finally, it was made generally available and received very positive customer feedback.

The engineering team continued to respond to customer requests and updated the integration accordingly. To meet a key customer need, they added the ability to send multiple documents in an envelope through the NetDocuments interface. Additionally, they added an option for the signed envelope to be returned as a new version of the original document, rather than an entirely new document. Both of these features further enabled NetDocuments customers to optimize their use of DocuSign.

The verdict: a win-win

By allowing customers to send DocuSign envelopes directly from the NetDocuments platform, the integration is a win-win. Users can send their documents more efficiently, and NetDocuments can ensure that documents remain in their secure, governable repository. NetDocuments was able to leverage not only the technical capabilities of DocuSign, but also its well-known standards of security—a key feature for a legal document system!

See for yourself how a DocuSign integration can help meet your customers’ needs. You can start exploring the DocuSign eSignature REST API with a free developer account. Visit our Developer Center to learn more!

Eleanor Harris
Eleanor Harris
Programmer Writer