To set up the integration with Yardstik, you'll need a Yardstik account with the ability to create custom integrations. You also must have developer permissions in Greenhouse Recruiting to configure the API key.
Create a Secret Key in Yardstik
Navigate to the Yardstik developer page click into the Integrations section.
Edit the Greenhouse integration.
Generate an API key to use as your Secret Key in Greenhouse.
Copy the API key you just generated and navigate to Greenhouse.
Create a new Web Hook in Greenhouse
With your Greenhouse API key from Yardstik copied you can create your webhook in greenhouse. Go to your Greenhouse account and create a webhook:
Click the Configure icon and navigate to the Dev Center.
Select Webhooks from the page.
Create a new webhook for the Yardstik integration.
Configure when the webhook will run by selecting an option from the When dropdown menu.
Enter the Yardstik API URL into the Endpoint URL field and enter the Yardstik API key.
In the Advanced Settings options, enter the following snippet to create a header to send the secret key with the request:
Set Disabled to No and click the Create Web hook button.
Create a custom field in Greenhouse Recruiting for the Yardstik integration
A custom field will be used with your integration to select the Yardstik Account Package for the candidate. When the integration is set up, this field will automatically include all of your available Yardstik Account Packages.
Navigate to Custom Options > Company Custom Fields > Jobs in Greenhouse Recruiting.
Click on the Add Field button at the top-right of the page.
Name your custom field Yardstik Package.
Choose field type Single Select and add in one option “None.” Make this field required, select the Mark Private option, and click Save.
Generate Greenhouse Harvest API Key
Navigate to the Dev Center in Greenhouse Recruiting (Configure > Dev Center) and select API Credential Management.
Click on Create New API Key button.
Select the following options from the window:
- API Type: Harvest
- Partner: Yardstik
- Description: Yardstik Harvest API Key
Copy the created API Key and paste it into the API key field in Yardstik.
Enter the name of the Greenhouse Recruiting custom field in Yardstik.
Select the following options to configure the API in Greenhouse Recruiting.
- Get: Retrieve Candidate
- Patch: Edit Candidate
- Post: Add Note
- Patch: Update Job
- Get: Get custom fields
- Post: Create custom field options
- Patch: Update custom field
- Delete: Delete custom field
Custom Field Options
- Get: Custom field options
- Post: create custom field options
- Delete: Remove custom field options
- Patch: Update custom field options
Setting Yardstik Values
- You will also have to choose a Greenhouse Admin user Id. This will be the Greenhouse user id of the person you would like to be used for all actions taken through the Greenhouse Harvest API. Paste this value into the Greenhouse Admin User ID in the Yardstik Integrations page and click Update
Finish Greenhouse Integration
After configuration is complete, you can turn on your Greenhouse Integration in Yardstick to enable the flow of data.
Example in Greenhouse Recruiting
When the status of the Yardstik report changes you will be notified in the notes section for that candidate.
When you create a job, your custom field will automatically include the Account Packages you have set up in Yardstik.
Once a candidate passes through the phase of hiring that you selected when creating the webhook, the Yardstik invitation will automatically be sent.