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
Startups
Financial technology
Real estate
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 center
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
/
Human resources advice

Add Offer Letter eSign to Candidate Tracking

by 
Luke Russell
November 2, 2021
5
minute read
"Add Offer Letter eSign to Candidate Tracking" header image
icon tooltip

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

icon close

Nowadays recruiters have access to applicant tracking systems (ATS) that simplify the process of candidate tracking and ensures that no step of the way is missed. Should you find yourself needing to build out an ATS that can effectively move candidates through the hiring process, you are likely familiarizing yourself with the hurdles and gaps that many recruiters experience daily—manually sending and tracking documents or redundantly filling out candidate data. By implementing an eSignature flow into the process using the HelloSign API, recruiters can experience a seamless end-to-end recruitment workflow that eliminates human error and reduces manual document management.


In this post we’ll demonstrate how the HelloSign API can automate the task of issuing candidate offer letters in recruitment workflows through scaling document creation and enabling pre-filled data fields.

‍

Automate Scaleable eSignature Doc Creation

First, let's look at how to use HelloSign templates to create a signable document online. Using either the HelloSign web app (or embedded templates), a recruiter can create a template by uploading a document, specifying the roles for the signer, and placing fields. A job offer form might contain three roles: Recruiter, Client, and Candidate.

Screenshot of HS template preparation page
Screenshot of HS template preparation page

‍

The fields for each role are placed on the document and can be either filled in by parties during signing or pre-filled with existing data available at the start of the signature request.


Let’s assume that the offer letter template have already been created for this example. You might start by parsing a list of templates by calling the List Templates (/template/list) endpoint using the HelloSign Python SDK.

‍

‍

Parse through the resulting template objects and grab the `template_id`. That parameter will allow you to reference that specific template when calling the API. Now you can send your offer letter by calling the Send Signature Request With Template (/signature_request/send_with_template) endpoint and passing in the template id and information about the parties signing.

‍

‍

We call this a “non-embedded” signature flow. Once this call is sent, the user will get an email prompting them to click a button and complete the signing on a HelloSign page. If you’d prefer candidates sign offers directly in your app, then you’d use embedded signing.


In this scenario, the different signers might still need to provide some information about themselves such as a phone number or address. However, we can make that signing experience more delightful for them by filling out some of those fields in advance using data we already have. This also eliminates a vector for user error.

‍

Pre-fill Data To Ensure Accurate Client Information

Using the HelloSign API, you can automatically pre-fill fields for each for each signer with data you already have in your AST app. These fields need to be configured as “merge fields” when the template is created and then passed back with the signature request using the `custom_fields` parameter.


When creating the template, you’ll select “Sender” on the Signers drop down and place a textbox in the document. Give the merge field a unique name that you’ll reference when making the signature request.

Setting a "Merge field" as a "Sender" to pre-fill data during signing
Setting a "Merge field" as a "Sender" to pre-fill data during signing

‍

Now, when you send the offer letter using the Send Signature Request With Template (/signature_request/send_with_template) endpoint, you include a new parameter called `custom_fields`. As long as the key in `custom_fields` matches a specific merge field, then the corresponding textbox will be pre-filled with that value.

‍

‍

Here, you can see that we passed the candidates name back so they don’t have to fill it out. In the real world, your AST app would likely pre-fill a lot more data! Such as length of job, amount of pay, and any other details that are already available from the AST when the signature request is created for the offer letter.

‍

There are two main benefits of using `custom_fields`:

  • A smoother signing experience — the signer doesn’t waste time filling out data you already have about them
  • Correctness — using your AST or other system as the source of truth eliminates a vector for human error

‍

Canceling Signature Requests

Once the offer letter signature request is sent to a candidate, there are a couple different paths that could be taken.


The candidate could accept the position and sign the document! In this scenario, HelloSign would send an email notification once the document is signed. You could also use HelloSign’s webhooks, which are called events and callbacks, to trigger a process that updates the candidates status in the AST software.


Alternatively, the candidate could decline the position. If that happens, the recruiter would need to update the candidate's status with in the AST software. You could use that event to cancel the signature request through the HelloSign API using the Cancel Incomplete Signature Request (/signature_request/cancel/:signature_request_id) endpoint.

‍

‍

Regardless of the outcome of a specific job offer, it's always good to build out functionality that can help identify a specific signature request later when you need it. That can be accomplished using the List Signature Request (/signature_request/list) endpoint in combination with search.

‍

Enhancing Candidate Tracking with Offer Letter eSign

Adding eSignature capabilities to an applicant tracking system is a huge value add for your users. It can help eliminate human error, reduce manual work, and keep recruiters focused on recruiting instead of chasing down paperwork. The HelloSign API is a fantastic tool for implementing this feature because it’s quick to implement and has powerful features to create a seamless eSignature experience for your users. Find out more on the HelloSign developer portal.

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:

illustration of a man with a ladder standing on a bunch of shapes slowly assembling them in a document
Human resources advice
4
minute read

Is it time to update your employment contracts?

A man is opening a handbook up and a bright shining light is showing on his face
Human resources advice
7
minute read

How to get started with an employee handbook

eBook

The definitive guide to eSignatures in fintech

Products
Dropbox SignDropbox Sign APIDropbox FaxIntegrations
Why Dropbox Sign
Electronic signaturesSign documentsSign and Fill PDFsOnline contractsCreate electronic signaturesSignature editorSign word documents
Support
Help centerContact salesContact supportManage cookiesGetting started: Dropbox SignGetting started: Dropbox Sign API
Resources
BlogCustomer storiesResource centerLegality guideTrust center
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