1. PageUp
  2. Knowledge Portal
  3. Recruitment Marketing
  4. Module maintenance
  5. Integrations
  6. Partners

Greenhouse

Updated

Recruitment Marketing

Public

This guide will walk you through the process of integrating your Greenhouse account with Recruitment Marketing.

Reading jobs from Greenhouse into Recruitment Marketing

To import jobs from Greenhouse the jobs must be accessible from a public jobs board.

In Greenhouse, you are able to make a job live without it being pushed to any other 3rd party source (i.e. only someone with that link will see the job).

Making a job live in Greenhouse

  1. Click on the job.
  2. Select Job Setup > Job Post > Get Started.



  3. Complete the job post.
  4. Click on job then click Job Setup then Job Post and switch the job from Offline to Live
  5. In order to ensure that the job is not published anywhere externally ensure the options for pushing the job to Indeed, Glassdoor, Simply Hired etc. are not selected.

Generating a Candidate Ingestion API Key

  1. In Greenhouse, navigate to the API integrations page - https://app.greenhouse.io/configure/dev_center/credentials
  2. Click the Create New API Key button.
  3. Select Candidate Ingestion as API type.
  4. Select Clinch from Partners list.
  5. Fill out the description field, for example: Clinch.
  6. Copy the API key as you will need it later.

Generating a Harvest API Key

  1. Navigate to https://app.greenhouse.io/configure/dev_center/credentials.
  2. Click Create new API key.
  3. In the Description field, enter Clinch Harvest.
  4. Set the Type as Harvest.
  5. You'll be asked to give us permission to certain parts of your account. We require permissions to the following areas:
    • Candidates
      • GET: Retrieve Candidate
      • GET: List Candidates
      • PATCH: Edit Candidate
    • Custom Fields
      • GET: Get custom fields
    • Jobs
      • Get: List Jobs
    • Job Posts
      • Get: List Job Posts
    • Offices
      • GET: Retrieve Office
      • GET: List Offices
    • Users
      • GET: List Users
  6. Click the Update button.

Configuration within Recruitment Marketing

  1. From the side menu, under Integrations click ATS.
  2. Click the New button.
  3. Click the Greenhouse logo.
  4. Complete the form details:
    • Name
    • Partner API Key - enter the candidate ingestion API key you created earlier
    • Harvest API Key - enter the harvest API key you created earlier
    • Job Board API Key - enter the job board API key from Greenhouse
    • Greenhouse User ID - necessary for API calls that require a user
    • Interaction Field ID - see below
    • Company Code - if unsure, refer to your Greenhouse documentation. By inspecting the URLs that begin with boards.greenhouse.io at the top of the page, you can find the code.
      The URL is of the form https://boards.greenhouse.io/<company_code>.
      For example: If your URL is https://boards.greenhouse.io/acmelimited then your company code is acmelimited.
    • How are locations chosen
    • Import job questions
    • Support internal jobs
    • Support external jobs

    • How are remote jobs identified? - select the field used to identify remote jobs

    • Regex to match remote job locations - enter the regular expression to identify fully remote jobs

    • Regex to match hybrid job locations - enter the regular expression to identify hybrid remote jobs

    • Identify hidden jobs using a jobs criteria
    • How often do you want to read jobs data from the ATS
    • How often do you want to read candidate data from the ATS
    • Sync translations
    • Import unknown candidates
    • Date to start synchronising candidates
  5. Click Save.

Writing a candidate's interaction score to Greenhouse from Recruitment Marketing

In Recruitment Marketing, the candidate interaction score feature gives your recruiters insight into a candidate’s interaction with your company. This next step allows your recruiters to access that information from within Greenhouse also making it easy to determine which applicants are most engaged with your employer brand.

  1. Visit https://app.greenhouse.io/custom_fields/candidates.
  2. Click Add Field.
  3. Complete the following fields:
    • Field - Interaction Score
    • Description - Clinch Interaction Score
    • Type - Number
  4. Click Save.

When set up, Recruitment Marketing will push interaction scores on a regular basis to Greenhouse.

Our interaction scores have recently been upgraded to take into account blog views, job views & video views. They will also degrade over time if the candidate has no recent interaction.

Maintaining attribution: adding Greenhouse tracking links

The Recruitment Marketing module works to deliver the best candidate experience pre-apply, i.e. its focus is on attracting, nurturing, and converting candidates, as opposed to managing applications.

If you are distributing your Recruitment Marketing-hosted jobs via the Greenhouse ATS and wish to avail of end-to-end source tracking and attribution, you can edit the Greenhouse tracking links to the relevant pages as follows:

  1. Navigate to https://app.greenhouse.io/jobboard.
  2. Next to the relevant jobs board, click Actions then Tracking Link.



  3. Make your selection for Who gets credit, then choose the source for which you want to establish attribution from the Select a source drop down.
  4. Click Create Link and note the short code, as below.



  5. When unpacked, the code will look similar to:
    https://company.career-pages.com/jobs/search?gh_src=29796c671
  6. Navigate to the job distribution area in Greenhouse
  7. Edit the tracking link to the relevant URL.
    With the above example: gh_src=29796c671
    The new link should look similar to:
    https://company.career-pages.com/jobs/channel-manager-emerging-markets-new-york-united-states?gh_src=29796c671
  8. To ensure that all is configured correctly, visit the job page using the new URL and complete a test application. You should see that the gh_src is passed across to the URL on the greenhouse form. This will allow for the correct attribution in Greenhouse.

Direct Apply to Greenhouse configuration

Overview

If you use Greenhouse as your ATS and have a relatively basic application form, Recruitment Marketing can accept candidate applications. This can improve the candidate's experience as they complete the application on the same page as the job description and do not need to interact with Greenhouse.

This is achieved by a two way integration:

  • Recruitment Marketing retrieves jobs and the application form questions from Greenhouse.
  • Application questions are displayed on an Apply Call-to-action.
  • Upon submission of the Apply Call-to-action, Recruitment Marketing will send the applicant details and completed application form to Greenhouse.

Any synchronized application form questions can be viewed when editing a job. To access:

  1. From the side menu, under Content click Jobs.
  2. Next to the relevant item click Edit Job.

Supported Greenhouse fields

Profile Questions

  • First Name - Mandatory field
  • Last Name - Mandatory field
  • Email - Mandatory field
  • Phone Number - Partially supported - Must be configured in Recruitment Marketing CTA. Answers are sent back to Greenhouse
  • Resume - Fully supported
  • Cover Letter - Fully supported
  • Location - Not supported - Use custom application question instead
  • Education (profile question set) - Partially supported - School and End date are supported only. Optional/Required per question within the set is not supported. Where at least one question is required in Greenhouse, all questions will be required in our CTA.

Custom Application Questions

  • Short Textbox - Fully supported
  • Long Textbox - Fully supported
  • Single Select - Fully supported
  • Multi-select - Partially supported - Multi-select checkbox only. Multi-select dropdown is not supported.
  • Yes/No - Fully supported
  • Attachment - Fully supported

EEOC Questions

  • Gender - Fully supported
  • Race - Fully supported - Displayed as a dropdown to select the Race. Asking Are you Hispanic/Latino? is not supported.
  • Veteran Status - Fully supported
  • Disability Status - Fully supported

Greenhouse setup

  1. Navigate to https://app.greenhouse.io/configure/dev_center/credentials.
  2. Click Generate new API key.
  3. In the Description field, enter Clinch Job Board.
  4. Set the Type as Job Board.
  5. Click Create.
  6. Under Job Board API, click to Copy the displayed token.

Recruitment Marketing setup

Contact PageUp to enable the functionality, then complete the following:

  1. In Recruitment Marketing, from the side menu, under Integrations click ATS.
  2. Next to Greenhouse, click Edit.
  3. In the Job Board API Key field, paste the copied token.
  4. Select the Import job questions checkbox.
  5. Click the Save button.

In order for the Greenhouse direct apply feature to work, candidate verification must be set to No form verification. To update the candidate verification settings:

  1. From the side menu, click Settings under Company
  2. Click on Candidate verification
  3. Update the setting to 'No form verification'
  4. Save

Now, you can set up your CTA to use direct apply:

  1. From the side menu, under Content click Calls-To-Action.
  2. Next to the relevant CTA, click the edit button (pencil icon).
  3. Tick the direct apply checkbox that reads "Will the candidate make a direct application from the call to action?". (This is only available for Apply URL CTA's).
  4. Click the Save button.
  5. Next to the relevant CTA, click # field(s).
  6. Click the New button.
  7. Complete the fields and in the What type of field is it drop down, select Job Application Questions.
  8. Click the Save button.

Note: To achieve a pilot launch of Direct Apply jobs, create a Direct Apply CTA, duplicate a job page template with the Direct Apply CTA and leverage Job Page Routing to specify the pilot job.

Greenhouse: Automatic sync of ATS candidate tags

For customers with an integration to the Greenhouse ATS, the tags attached to candidates within the ATS will now be automatically synchronized to the CRM profile of the corresponding candidate within Recruitment Marketing. If a tag is added or removed from the candidate’s profile in the ATS, this will automatically update on their CRM profile the next time the candidate integration runs. It should be noted that tags which have been added to the candidate directly within Recruitment Marketing, either manually by a user or as the result of a workflow, will not be affected by the synchronization of tags with the ATS.

Table of contents

Articles in this section

See more