How can we help you?


DocuSign is a cloud-based System of Agreement Platform, which allows companies to quickly modernize and digitize the entire agreement process on practically any device.

Greenhouse and DocuSign have created an integration so that you can seamlessly use the two products together to send offer letters to candidates and obtain signatures electronically.


General Information

The Greenhouse/DocuSign integration is activated on a per-user basis instead of being activated by only one user for the entire organization. That is, every user who wishes to use the integration will need to follow the set up instructions below. To use the DocuSign integration with Greenhouse, your team will need to work with your DocuSign Account team to purchase the appropriate plan. The integration was set up this way to simplify permissions and ensure that everyone who should have access to send documents is able to do so without problems.

If your organization is currently using SSO to connect to DocuSign, you will need to be on the new version of SSO that DocuSign supports, rather than the legacy version. Send on behalf of (SOBO) settings do not need to be configured within Docusign before enabling the integration and sending out offers. Users can only send from their own email address, but all documents will be saved against that user account when logging into DocuSign.

You can access the integration with DocuSign's Web Plans account, however, the integration functionality will be limited. DocuSign recommends purchasing a Business Pro plan to get additional functionality. 

Below is a general outline of the process to send offer letter templates with the integration: 

  1. Enable the integration. Each person with access to your organization's DocuSign account will need to enter their username and password on Integrations to connect their DocuSign account to Greenhouse. 
  2. Add special DocuSign tokens to offer letter templates, and upload them to Greenhouse.
  3. When creating an offer for a candidate, generate the offer letter using the template that contains the DocuSign token(s).  
  4. Choose the option to send the offer letter to the candidate via DocuSign. Greenhouse users with the Can see private notes, salary info, manage offers, and approve jobs/offers permission will be able to send offer letters through the DocuSign integration.
  5. Preview the document in DocuSign, and then send from there.
  6. Once all signatures have been collected, the fully executed document will automatically be uploaded as private attachments on the candidate's details page. 


Enabling the Integration

To enable the integration in your individual Greenhouse account, click the ellipsis from the navigation bar and select Integrations from the dropdown menu.


Use the provided search bar on the Integrations page to search for DocuSign and select it from the populated search list.

Click Connect from the DocuSign integration page.


You will be redirected to DocuSign where you can enter your DocuSign credentials. If you use SSO, you will be redirected to your authentication provider for DocuSign. Otherwise, you will need to enter your password. 


Once you sign in, you'll be redirected back to DocuSign integration page in Greenhouse and the integration will say Connected.



Add DocuSign Token(s) to Offer Letter Templates and Upload

Note: If you have yet to create an offer letter template in Greenhouse, click here to read the full set of instructions.

With the DocuSign integration enabled, there will be four additional tokens available to include in the offer letter template you create:


Note: Originally, the Greenhouse/DocuSign integration supported 3 tokens: {{CANDIDATE_SIGNATURE}}{{COMPANY_SIGNATURE}} and {{SIGNATURE_DATE}}. While we strongly recommend users update their existing offer letter templates using the new tokens, the legacy token {{SIGNATURE_DATE}}is still supported at this time. 

The placement of these tokens will determine where the electronic signatures will go in the offer leter template. DocuSign tokens need to be on their own line within templates to work correctly. Please see below for an example:


Once you've created the offer letter template, you are ready to upload it to Greenhouse! Navigate to the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.png in the upper right-hand corner and select Offer Templates from the left-hand panel.

Click Upload New.


From the subsequent dialog box, fill in the appropriate fields and click Choose File to locate the file on your computer. When finished, click Save Template.


Once uploaded, navigate to the offer letter template from the list and click Test. This will check the template for any unsupported tokens in the template. If all tokens in the template are supported, the offer letter template status will read Verified



Generate and Send Offer Letter with Docusign

In order to take advantage of the DocuSign integration, the offer letter must be generated through Greenhouse. To generate and send an offer letter, navigate to a candidate's profile.

From the candidate's profile, navigate to Offer Details tab and click Create Offer. Fill in the appropriate fields.


Once an offer exists, navigate to the Offer Documents section and click Generate. From the Generate Offer Document dialog box, use the provided drop-down menu select the appropriate template. Click Generate

Screen_Shot_2018-09-10_at_11.59.14_AM.png next_318-140722.jpg Screen_Shot_2018-09-10_at_11.59.33_AM.png


Once the offer letter has been generated, click Send with DocuSign.


From the Send with DocuSign dialog box, you will be able to select an email template or simply type the message to the candidate to go along with the offer letter. To proceed with sending the letter, click Preview on DocuSign

Note: If the offer letter you've generated includes the {{COMPANY_SIGNATURE}} token, don't forget to select the appropriate user from the To User field.

Clicking Preview on DocuSign will launch DocuSign. From here, you can add fields or choose to send the letter by clicking Send.



Track Signatures and Access Fully Executed Letter

You can check on the status of the document within Greenhouse while viewing the details of the offer.  There are three statuses that will be displayed in Greenhouse: 

A long dash is displayed when the offer document has been sent to the candidate via DocuSign and is awaiting action from the candidate. image__5_.png
"Pending" is displayed when the candidate has reviewed the offer document sent to them via DocuSign but has not yet signed it. image__3_.png
A date is displayed when the candidate has signed the offer document.  You'll also notice a green checkmark to the left of the candidate's email address where there was previously a white circle.  image__4_.png

The user who sent the offer letter will receive notifications via email when all of the signatures have been collected. The fully executed letter will automatically be uploaded and accessible on the candidate's details page.