Emissary is a text recruiting platform built to make candidate engagement easy. It empowers recruiting teams, HR departments, and staffing firms with efficient tools that work in harmony with any ATS, HRIS, or recruiting site.

Greenhouse Recruiting's integration with Emissary allows you to access your SMS-based Emissary conversations within Greenhouse Recruiting. This is not only for your convenience, but also provides a transcript record for each candidate that can be preserved for posterity. Each Emissary inbox may be linked to, at most, one Greenhouse Recruiting account. This setup process needs to be performed once for each inbox.

Create a Harvest API key for the Emissary integration

To configure the Greenhouse Recruiting / Emissary integration, you'll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Emissary integration.


In the Create New Credential box, make the following selections:

  • API type: Harvest
  • Partner: Emissary
  • Description: Emissary Harvest API key


Verify that the following permissions are selected for the Emissary integration:


  • All permissions


  • All permissions


Add Harvest API Key to Emissary

Navigate to your Emissary inbox and locate the Tenant dropdown. Click ATS Integrations.

Click Integrate Greenhouse next to the Greenhouse Recruiting logo.

The next step guides you through a list of instructions for creating a Harvest API key in Greenhouse Recruiting that you completed in the first section of this article. 

The final step of the process prompts you to paste the Harvest API key you created in Greenhouse Recruiting.

Provide the API key, then click Finish Integration.

That is it! The page displays the integration and the number of contacts being actively synced between Emissary and Greenhouse Recruiting.

Note: The integration uploads candidate conversations nightly to Greenhouse Recruiting in order to provide a full day's worth of conversation at a time, so conversations will not appear immediately in Greenhouse Recruiting. Any conversations that exist in your Emissary inbox before it is linked to your Greenhouse account should be visible the morning after the first synchronization process. Likewise, any subsequent conversations should appear each following morning.

Use the Emissary integration with Greenhouse Recruiting

Once the integration setup steps are complete, using the Greenhouse Recruiting / Emissary integration is simple. Conversations will take place throughout the day while using the various tools of Emissary's Text Platform. Through the integration, those conversations will be saved each day within Greenhouse Recruiting.

Here is an example of what a text exchange looks like in Emissary's web interface (Emissary's Inbox):

To access the text conversation transcript in Greenhouse Recruiting, navigate to the candidate's profile page, then click the Details tab.

Scroll down the page to the All Attachments section to find the transcript.

Click the transcript to view or download the attachment.

The extension is also available using Emissary's Chrome plugin.