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 -
  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
  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
    • Demographic Data
      • Get: List Demographic Questions
      • Get: List Demographic Question Sets
      • Get: List Demographic Answer Options
  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 at the top of the page, you can find the code.
      The URL is of the form<company_code>.
      For example: If your URL is then your company code is acmelimited.
    • How are locations chosen - Location data for a job can be read from the "Location Name", or in the event of multiple locations, the "Office Location".
    • Import job questions
    • Support internal jobs - Caution: Only check this if you would like to display jobs that are posted internally and jobs that are posted both internally and externally. This is only recommended for use with internal careers pages.

      • A Greenhouse job can have many job postings. A job that is posted internally and externally on Greenhouse will appear twice in Recruitment Marketing if both "Support internal jobs" and "Support external jobs" are selected.
    • Support external jobs - Caution: Check only if you would like to display jobs that are posted both externally and jobs that are posted both internally and externally. This is only recommended for use with external careers pages.

    • 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 - use the job filtering language to specify which jobs should be hidden e.g. ats_uid = "123" or department = "hidden".
    • 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 - if the careers site will be translated into multiple languages, then enable this setting.
    • Import unknown candidates - By default only candidates that have applied through the careers website will have their ATS data imported. Enable this setting to import all candidates in the ATS who have recently been updated.
    • Date to start synchronising candidates - This is a way to import historical candidate data. The Candidate ATS synchronisation process will use this date to import historical candidate data rather than just candidates who have been updated since the last successful synchronisation process. It is an advanced setting, usually used when setting up an account. 
  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
  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
  2. Next to the relevant jobs board, click Actions then Tracking Link.

    adding-greenhouse-tracking links

  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:
  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:
  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


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
  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.

Note: 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.

Internal careers sites

With an external job, candidates that complete an application call-to-action are redirected to the job's apply url. However, a Greenhouse internal job will not have a related Greenhouse jobs board and therefore will not have an apply url. There are two approaches to solving this:

  • Direct Apply
  • Construct the apply url from a template string

To construct apply urls from a template string:

  • Edit the Greenhouse ATS integration.
  • Choose "Build it from the templated text field below" in the "How is the Apply URL constructed?" field.
  • Populate the templated text with a value approved by your Greenhouse contact. Most likely it will be something like{{job_post_id}}.
  • When the ATS synchronises, each job's apply url field will be populated and the candidate can apply as usual. The candidate will, however, need to sign in to Greenhouse using SSO to get to the Greenhouse application form.






Article is closed for comments.