1. Greenhouse Support
  2. All Recruiting topics
  3. Integrations
  4. Job board

Jobtrees integration

Streamline hiring with Greenhouse Recruiting's Integration with Jobtrees. This integration allows you to simplify posting jobs, sourcing top talent, managing applications and communicating status updates by integrating the following features with Greenhouse Recruiting:

  • Post your jobs on Jobtrees.com
  • Collect and consolidate applicant data
  • Identify the most suitable candidates based on your job criteria
  • Automatically update candidates on their status

By leveraging this integration, recruiters can efficiently find and engage with the best talent while only paying for results, not traffic.

In this article

Set up a Jobtrees account

To set up this integration, you'll first need a Jobstrees account. This profile includes company-specific date and payment information, as well as information needed to link your Jobtrees account to Greenhouse Recruiting.

After you create this account, most of your Jobtrees information can be updated directly within Greenhouse. Only payment and budget information must be managed directly in Jobtrees.

To set up your account, navigate to Jobtrees' employer page at https://www.jobtrees.com/post-a-job.

Click Start Hiring Now or Sign-Up to launch the register screen.

Register with your email address or use a social sign-in to create your Jobtrees user account.

After completing the registration steps and are logged in, you should be directed to the employer registration page. If this page doesn't automatically open, navigate to https://www.jobtrees.com/employer-setup.

Enter the basic employer information (Company Logo, Company Name, No of Employees and Phone Number), click the Enable a software integration connection (ex Greenhouse) check box, and click Save and continue.

Next, you'll need to enter some information created in Greenhouse to complete your integration. Keep this page open and follow the steps below to create a Harvest API key, retrieve your user IDs, and retrieve your optional Job Board API key.

Retrieve user ID

Jobtrees will need a Greenhouse Recruiting user ID to associate with updates and changes created by the integration.

Click the Configure icon on your navigation bar and then click Users on the left.

Click Export to Excel.

A spreadsheet will be downloaded to your computer. Open the Excel file and locate the user ID in the User ID column.

Copy the User ID from the spreadsheet and paste in the User ID field on your Jobtrees employer company details page.

Create a Harvest API key

To configure the Jobtrees integration, you’ll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Jobtrees integration.

Credentials

In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Jobtrees or Unlisted Vendor
  • Description: Jobtrees Harvest API Key

Permissions

Verify that the following permissions are selected for the Jobtrees:

  • Select All

Paste the API key in the Harvest API Key field on your Jobtrees employer company details page.

Add demographic questions with the Job Board API key

If you have demographic questions included as part of your application process, providing a Job Board API key allows us to connect to your job board and retrieve those questions for your applicants.

To enable this feature in Jobtrees, select Enable demographic info and follow the steps below to create a job board API key in Greenhouse.

To create a Job Board API key, follow the steps in this article and use the information below when creating your API key:

  • API Type: Job Board
  • Partner: Jobtrees or Unlisted vendor
  • Description: Jobtrees job board API key

Click here for more detailed information on setting up a job board API key for a partner.

Once it's created, paste the copied Job Board API Key into the designated field on https://www.jobtrees.com/employer-setup

Complete your Jobtrees account setup

Once the steps above are complete, finish the budget and payment details sections with the required info and click Update.

Note: Secret Key & Additional HTTP Headers are available as part of your Jobtrees setup and are used to create webhooks in the next steps in the integration.

Create a custom job field

Next, in order to use the Jobtrees integration, you'll need to create a custom Jobs field in Greenhouse Recruiting.

To create a custom Jobs field, click the Configure icon Configure icon on your navigation bar, then click Custom Options on the left.

Click Jobs.

Click Add field, and enter the following details to configure the new field:

  • Name: Publish On Jobtrees
  • Type: Yes/No
  • Description: Determine whether to list this job on Jobtrees. Select "Yes" to publish or "No" to exclude. (Paste this or a similar description into the ‘Description (optional)’ field)

Create a webhook

To integrate Jobtrees with Greenhouse Recruiting, you’ll need to create 7 webhooks. Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook:

Webhook 1: Job Updated

Webhook 2: Job Created

Webhook 3: Job Post Created

Webhook 4: Candidate Stage Change

Webhook 5: Job Delete

Webhook 6: JobPost Update

Webhook 7: Candidate Reject

Note: For each webhook, click on ‘Advanced settings…’ link further down in the webhook set-up page to see an “Additional HTTP Headers” box and paste the Additional HTTP Headers value from the Jobtrees employer set-up page here ensuring that the words “Employer ID” are included before the number (this will automatically happen if you use the copy function on the Jobtrees page).

The Additional HTTP Headers’ value is available on the Employer’s Company Details page. https://www.jobtrees.com/employer-company-details

Leave the maximum attempt value as defaulted and click the ‘Create Webhook’ button

Reminder: The Endpoint URL, Secret Key and Additional HTTP Headers are the same values for all Webhooks, The value for the Secret Key and Additional HTTP Headers is on the Jobtrees Employer Company Details page.

Use the Jobtrees integration with Greenhouse Recruiting

Seamless Job listing Integration

Upon completing the one-time integration steps above, with a couple additional clicks, you will be able to choose which jobs you post to Jobtrees to gain access to our talented and focused group of job seekers. Aligned with your set budget, Jobtrees will highlight your active roles as they are relevant to our job seekers and seamlessly integrate applicants into your Greenhouse instance. Any updates you make to your job postings on Greenhouse automatically flow through to what’s shown on Jobtrees. As you close roles or remove them from active recruiting, they’ll be removed from Jobtrees as well so only the active listings you have shared will appear on the site.

How your jobs get added, updated, and removed on Jobtrees

Jobtrees will pull in new and updated job postings from your Greenhouse portal live (within seconds) and show those updates on Jobtrees including removing any closed or paused postings.

Jobtrees uses the following indicators from your Greenhouse instance when performing updates:

  • Publish on Jobtrees set to “Yes”
    • This is the population of jobs they evaluate for update
    • If this is changed to “No”, the job will be removed from Jobtrees
  • The job ID
    • If this is new, they will create a new job on the Jobtrees site
    • If the job ID already exists on Jobtrees, they will evaluate it for any updates to posting information or status and flow those updates thorough
  • The partner’s job budget
    • If there is budget unspent within the budget period (either at the job level or overall based on the partner’s selection) the job will appear on Jobtrees
    • If there is not budget available, the job will not be shown until there are new funds added or the next budget period is reached

Interacting directly on Jobtrees

As part of the integration set-up you will need to create a Jobtrees account for your business on Jobtrees. You can choose to leverage the Jobtrees interface to review candidate data but with the exception on updates to payment info, budgets and viewing candidate eval scores, everything can be done in your Greenhouse environment. The data flows seamlessly between the two instances eliminating the need to duplicate or miss tasks across the two systems.

Additional resources

For additional information or troubleshooting not covered here, please reach out to employerportal@jobtrees.com