Skip to main content
No items found.
logo dropboxsign
Why Dropbox Sign?
Expand or collapse accordion

What you can do

Sign documents online
Create electronic signatures
Choose or create templates
Fill and sign PDFs
Complete online contracts
Document management
Explore features
icon arrow right

Use Cases

Sales and business development
Human Resources
Start-ups
Financial technology
Property
On-demand services
Products
Expand or collapse accordion
icon dropbox
Sign
Make it easy to send and sign
icon dropbox
Sign API
Integrate eSign in your workflow
icon dropbox fax
Fax
Send faxes without a fax machine
icon dropbox integrations
Integrations
We meet you where you work
Resources
Expand or collapse accordion
Blog
Workflow expertise & product news
Customer stories
Real-world stories with real results
Help Centre
In-depth guidance for our products
Resource library
Reports, videos and info sheets
Developers
Pricing
Expand or collapse accordion
Dropbox Sign pricing
Find the right plan for you
Dropbox Sign API pricing
Real-world stories with real results
Contact sales
Sign up
Contact sales
Sign in
Expand or collapse accordion
Dropbox Sign
Dropbox Forms
Dropbox Fax
Free trial
Blog
/
Developers

Creating Approval Workflows with Multiple Signers

by 
Taylor Krusen
October 14, 2021
5
minute read
"Creating Approval Workflows with Multiple Signers" header image
icon tooltip

New look, same great product! HelloSign is now Dropbox Sign.

icon close

Approval workflows with multiple signers are everywhere! You might find a parent signing their newly licensed dependents onto their existing car insurance policy, or a group of college grads co-signing a rental lease on a new house. In business, lengthier processes like mergers and acquisitions will inevitably lead back to lengthy and complex legal documents with multiple levels of approval.


In any scenario, dealing with multiple signers in a signature-based approval workflow is hard. With physical documents you might get lucky and have everyone in the same place. However, this can get overly complicated if that’s not the case or if new signers are added at different stages, and might require multiple phone calls or meetings to obtain signatures from all parties.


In this article we’ll examine how you can use the Dropbox Sign API to build great signing experiences for your users, especially in approval flows with multiple signers.

‍

Send Documents to Multiple Signers

‍

Preliminary

Please complete our official Quick Start if you’d like to use the samples in this article. We’re going to be using the Dropbox Sign NodeJS SDK throughout.

‍

Send signature request

Imagine you’re running a business where many of the employees are remote, and you just started offering them corporate cards to take care of simple transactions. Quickly you realize that you need a process in place that can handle multiple approvers, especially for bigger purchases, and the ability to notify Finance for record keeping. Because teams might be geographically spread out, it’s not only fine for signing to happen at different times, it’s actually necessary.

‍

You can accomplish this using the Dropbox Sign API by calling Send Signature Request (/signature_request/send) and passing multiple signers. You can even specify the order and send a carbon copy to the finance department so they receive the approved expense report.

‍

‍

In the request above, we’re sending a signature request to Taylor who manages Roshawn. After Taylor receives and signs the request, Roshawn is able to sign the report before sending a completed copy to the finance department. We specified the signing `order` with the order parameter. We’re also making use of `metadata` to store a unique string on the signature request. In production, you might do this so you can easily identify the signature request in the future through search.

‍

Embed Documents for Multiple Signers

Now let’s look at a different scenario where we typically see signing complexity increase with multiple parties involved. Pretend you’re building a web app to help banks and FinTech companies complete approval workflows more quickly. Because your target clientele is sensitive about security and customer data, you want to avoid sending them outside of the app to conduct different aspects of the approval workflow.

‍

You can use the Dropbox Sign API to build embedded signing directly into your app. This signing flow has a few additional steps: generating the embedded signature request, creating an embedded object, and embedding the signature request into the front end of your app. This signing flow requires special consideration when building for multiple signers, which we’ll cover in the context of the example below.

‍

Generating an embedded signature request

The first step is calling Send Embedded Signature Request (/signature_request/create_embedded):

‍

‍

The request above will return a signature request object. Within that object, there’s an array of `signatures`. Every entry in that array represents a unique `signature` object for each individual signer (even if they’re signing the form in multiple places). In an embedded signing flow with multiple signers, we recommend saving that `signatures` array to a database, where you can retrieve the respective `signature` as needed when a party is ready to sign.

‍

Creating an embedded object

Once a signer logs into your app and is ready to complete their signature, you’ll need to generate an embedded object for them. The subsequent `sign_url` can be embedded into the front end of your app. You’ll need a unique `sign_url` for each respective signer on your signature request.

‍

Each signature object contains a unique `signature_id`, which gets passed to Get Embedded Sign URL (/embedded/sign_url/:signature_id) when that party is ready to sign.

‍

‍

The temporary `sign_url` from the embedded object must be passed passed to the front end of your application, where it can be embedded in an iFrame.

‍

Embed signature request on front end

The embedded signing functionality relies on a client side library called hellosign-embedded. You’ll need to include this library in the front end of your app through a package manager (such as npm) or cdn.

‍

Using the `sign_url` you passed from your back end, you can call the `open()` method available on the hellosign-embedded library.

‍

‍

Note that this JavaScript implementation is suitable for inserting into a `<script>` tag in plain HTML. In production you’d likely use a front end framework such as React or Django. The important part is that this code executes in the context of your browser.

‍

Using embedded signing with multiple signers

Creating a great embedded signing experience in an approval flow with multiple signers depends on effectively managing the flow of information in your app. In general, you’ll want to create and store the signature request. As signers access your app, you’ll pull up the signature request (likely by `signature_request_id`), grab their corresponding `signature_id`, create a `sign_url` that gets passed to your front end, and embed it into an iFrame using hellosign-embedded. You’ll repeat that process for each respective signer. Once the document is completed it will be sent to all parties.

‍

Delighting multiple signers

When your business is moving from pen and paper to eSignature, the complexity of approval workflows that require multiple signers can be scary. But don’t let that stop you! Digitizing legacy approval workflows that rely on signature is a huge value add for your business. The Dropbox Sign API offers two main signature flows, embedded and non-embedded, that can help you implement seamless approval workflows for multiple signers. You can learn about our other API features and find additional resources in our developer portal. Happy signing!

Stay in the loop

Done! Please check your inbox.

Thank you!
Thank you for subscribing!

Lorem ipsum

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

Lorem ipsum
icon arrow right
icon close

Up next:

Close-up illustration of a handwritten signature, representing modern digital signing solutions.
Developers
15
minute read

Integrating Dropbox Sign with Ruby on Rails: A Step-by-Step Tutorial

Close-up illustration of a handwritten signature, representing modern digital signing solutions.
Developers
15
minute read

Dropbox Sign vs. SignNow for developers

eBook

How To Onboard Contractors & Employees at Scale

Products
Dropbox SignDropbox Sign APIDropbox FaxIntegrations
Why Dropbox Sign
Electronic signaturesSign documentsSign and Fill PDFsOnline contractsCreate electronic signaturesSignature editorSign word documents
Support
Help CentreContact salesContact supportManage cookiesGetting started: Dropbox SignGetting started: Dropbox Sign API
Resources
BlogCustomer storiesResource CentreLegality guideTrust centre
Partners
Strategic PartnersPartners locator
Company
CareersTermsPrivacy
icon facebookicon youtube

Accepted payment methods

Mastercard logoVisa logoAmerican Express LogoDiscover logo
CPA Compliance BadgeHIPAA compliance badgeSky High Enterprise Ready badgeISO 9001 Certified badge

Dropbox Sign electronic signatures are legally binding in the United States, European Union, United Kingdom and in many countries around the world.
For more information, please view our Terms and Conditions and Privacy Policy