Grayscale’s conversational recruiting platform makes it easy to text with candidates from within Greenhouse, while automating repetitive tasks in the hiring process.  

Greenhouse Recruiting’s integration with Grayscale offers powerful texting capabilities for engaging with talent from directly within Greenhouse. In this article, we will cover how to: 

NOTE: In order to enable the Greenhouse/Grayscale integration, you will need developer permission to manage ALL organization’s API Credentials. Contact a Greenhouse admin user from your organization to set up the integration or to enable you with developer permissions.
​

To create a Harvest API key for the integration, click on the Configure icon

in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

From the API Credential Management page, click Create New API Key to generate the API key for Grayscale.

From the Create New Credential dialog box, make the following selections:

When finished, click Manage Permissions to generate the Harvest API key and automatically assign it the appropriate permissions required by Grayscale.

In the subsequent dialog box, click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Grayscale in the next step. Click I have stored the API Key once you have copied and saved the key.

Note: You cannot access the full API key again after clicking I have stored the API Key. If you lose your API key and need to access it later, you must create a new API key, provide it to the integration partner, and then revoke access to the original key.

On the Manage API Key Permissions page, click Select All, then scroll to the bottom and click Save. 

NOTE: Only want to include the minimum number of permissions with your API key? Here is the list needed to power Grayscale's current capabilities:

The final step is to save your Greenhouse API inside of Grayscale. 

To do so, navigate to Settings either in Grayscale's Chrome extension or in the browser version of the platform. 

Look for the section labeled ATS Integration.

From there, select Greenhouse from the dropdown menu, paste your API key, and select the appropriate name from the dropdown menu (we recommend the Greenhouse administrator). 

Then hit Save.

Once you save the API key, you'll see a section appear labeled Incoming Webhooks. 

You'll paste both the URL and Secret code back in Greenhouse (details below).

PRO TIP: We recommend copying and pasting the URL and Secret code somewhere you can easily access again, as you'll be doing a bit of copy/paste in steps to follow.

Navigate back to the Dev Center in Greenhouse. 

From the Dev Center page, scroll to the bottom click Web Hooks. 

You will be directed to the below page where you can create a new web hook.

From this Create A New Web Hook page, you will create 15 web hooks to enable all integration capabilities. To get started, follow these steps one by one: 

Web Hook #15 (Greenhouse CRM users ONLY): Prospect Created

Whew, you made it! Your Greenhouse integration is all set up and ready to go!

Activity Feed Sync
Your conversation history will be automatically saved in the Activity Feed for the candidate, so you have a record of the texting conversation directly on the candidate profile. 

NOTE: We import the entire conversation 1 hour after the last message is sent/received to ensure the entire communication is organized together in the same note. 

Seamless Bulk Messaging
When sending bulk messages, you'll be able to search open jobs in Greenhouse directly from our Chrome extension to find relevant candidates to message.

So if you want to quickly bulk message all candidates at the 'Phone Interview' stage of an open req, just search for the job, select the stage, and off you go!

For Greenhouse CRM customers, you'll be able to search by Pools and select all candidates at specific stages. 

Quick Search Across All Greenhouse Candidates & Prospects
Seamlessly search across all your candidates in Greenhouse to find the right candidate to message.
​

My texting history isn’t displaying within the Activity Feed. 

We update the activity feed one hour after the latest text message was sent/received for that candidate. This ensures your entire conversation is organized within the same note in the feed. If it’s been over an hour, try refreshing the page.  

My Greenhouse API key turned red when I created it in Greenhouse. Is that normal?

No, your API key should be green. If it's red, that means there's a problem with how it's set up. Go back through the API key setup steps above, and if the problem persists, you may need to loop in Greenhouse support. We're here to help troubleshoot as well.

Still having issues?  Live chat with us below and we'll help you out!