How do I setup an integration with Greenhouse? Follow
Splash’s integration with Greenhouse automates the recruiting process by syncing candidate data quickly and accurately by tracking candidates sourced from, and influenced by, events.
|Download the Greenhouse PDF Guide|
How do I create a Greenhouse integration?
Where to begin:
1. From your Integrations dashboard, click New Integration.
Choose Greenhouse Candidates and Prospects (v2) from the list of available integrations:
* Don’t see Greenhouse? Reach out to your CSM to make sure you have access!
2. Once you have selected “Choose” under Greenhouse Candidates and Prospects (v2), you'll be prompted to fill out specific fields to authenticate your account. These fields include:
- Harvest API Key
- Make sure prior to authentication that your API Key has the correct permissions. Check out what permissions you need here: How to create a Greenhouse API Key for Splash.
- Greenhouse User Email
Once you have both the Harvest API Key and Greenhouse User Emails entered, scroll to the bottom and select Save.
3. Integration Name and Triggers: Once the account authentication process is complete, you'll be able to enter an Integration Name and Trigger(s).
By default, the Integration Name field displays Greenhouse Candidates & Prospects (v2). Simply enter a new name for the integration if desired.
The Action field indicates the action the integration will perform. This read-only field displays Prospect Action and may not be changed.
The Trigger field indicates the cause for the integration to take this action. The triggers available in the pick list represent actions guests can take. As a heads up, Greenhouse only fires on Attendee actions, not event creation.
If the Attendee Action being configured, for example, is RSVP Yes, that means when a guest registers for an event in Splash, that information will be sent to Greenhouse.
4. Trigger Conditions: Next, you can configure your integration Trigger Conditions to fire only for specific events types.
Let’s say you have recruiting events plus internal events. You can dictate that your recruiting events attendees sync to Greenhouse, but your internal events don’t.
Simply check the box next to Only Trigger for Specific Event Types and chose from your Event Type List:
By leaving this section blank, the integration is set to apply to all events and user groups.
5. Notes in Activity Log: Now, we need to update the Notes section. This element, enabled by default, is used to write notes about guest actions to the Greenhouse Activity Feed.
Notes are set up as templates with both static text and dynamic tags. Combining the two creates meaningful notes that change according to context, and can be added to the activity feed.
A dynamic tag stands in for information that will be filled in later when the integration runs, much like a variable in a script or program. You can access a complete list of available tags by clicking on the View Dynamic Tags link just below the field.
6. Tags: Right under your Notes section, you also have Tags:
Tags are used to capture more searchable information about candidates. By default, this feature is not selected. Select the checkbox above the Tag Template field.
Similar to Notes, Tags use a combination of dynamic tags and static text to convey dynamic information. You can choose to use Notes, Tags, both, or neither - it is entirely up to your organization’s needs!
Mapping Fields to Greenhouse
Mapping the integration defines what information is synced from Splash to Greenhouse and identifies where Splash sends this information to in Greenhouse.
Fields are mapped by first choosing the data for Splash to send to Greenhouse. This consists of an object and an associated field from that object. Next, identify the Greenhouse candidates and prospects field to which the information maps.
- Click the Add a Field button.
- In the Splash Object field, select the object to map. This will determine where the Splash Field is pulling from.
If you select Contact, you will see form questions and guest information. If you select Event, you have the option to map information from your Event Settings.
- In the Splash Field dropdown, select the data field to map. As an example, this could be First Name of a guest or Event ID:
- In the Remote Field dropdown, enter the name of the Greenhouse field the Splash information will be mapped to.
This field searches through the Greenhouse fields to find a match to the text being entered. Once the field being sought is found, select it.
- Repeat these steps to map all the desired values.
Please note: first_name and last_name are required fields in Greenhouse and can't be removed.
Adding a Resume Form Question
One of the most central parts of Greenhouse is collecting resumes and keeping track of the positions in which prospects have an interest. Splash helps to collect this information by mapping Splash Form questions to Greenhouse Candidate fields. Let’s see this by first adding questions to the event form.
- In the Splash Event Dashboard, select the Registration Form touchpoint.
- Select the Add Question button.
- Locate the Resume question and click Add to Form.
- The form is updated to include the Resume field and a prompt to drag and drop or upload a file.
Add a Job Title Form Question
- Job Title requires a bit more setup since the job names to display differ from the job IDs used by Greenhouse to track them.
- In the Registration Form, select the Add Question button.
- In the Choose Question window, navigate to the Create New tab.
- Select the Radio option.
- In the Label field, enter a label for the new question. This is what your candidates will see when submitting the form.
- Use the Field Name to identify the question, such as job_id.
- Click the Advanced menu accordion.
- Below the Helper Text input field, locate the Response options values are the same as label option, deselect it. Now when creating your answers, they can have user-readable labels while retaining the Greenhouse job ID behind the scenes
- In the Radio Options section, add a new job option.
- Once created, click to access the options. In the Option Value, enter the job ID number as it might appear in Greenhouse.
- Click Done and repeat this for any additional options.
- Once you have finished creating your options, click Save to lock in your changes.
Note: Be careful not to overwrite the visible name with the Option Value accidentally.
Mapping the Fields
Resumes and Jobs are fields in Greenhouse, just like a name or email address. Just as in section 5.1, resumes and jobs can be mapped from the contact in Splash to the corresponding remote field in Greenhouse. Back in your integration:
- Create two new field mappings.
- Set both objects to Contact.
- Set the Splash Field for one to Resume, and the other to Job Title.
- Then in the Remote Field dropdown, select the corresponding Resume and Jobs options.
- Turn on and Save the Integration: When configuration is complete, save all your work by clicking the Save button. Then scroll to the top of the integration and toggle the switch to turn it On.
Note: Splash can map information to the first 100 custom fields in Greenhouse. Anything beyond the first 100 fields won't appear as a Remote Field option and cannot be mapped.
If an issue occurs with the integration, use the Activity Log to troubleshoot. Access the log via the button located on the bottom-left side of each configuration. It contains a complete record of everything that has happened to the integration.
Please sign in to leave a comment.