There are several different ways to integrate jobs in Greenhouse Recruiting with your careers page. Ideally, you'll want Greenhouse to power the careers page on your organization's website so candidates can easily apply online. Once integrated, all options provide comprehensive source/referral tracking, support for custom fields, and the ability to upload a company logo.
Before you start
Set up a job board
First, you need to have a job board to integrate. If you haven't created a job board, click here to learn how. Make sure the job board's status is set to Live.
Grant developer permissions
Depending on the integration type you choose, you may need to change your developer permissions.
To give your developers access, make sure they have the Developer Permission Can manage Job Board-related API credentials.
Choose an integration
There are multiple integration options to choose from. The options vary in setup time, complexity and customizability.
There are detailed descriptions in the application under Configure > Dev Center > Careers Page Integration Options.
Your developers can click the How to integrate link to get more detailed instructions on how to set up each option.
Host a job board with Greenhouse
The simplest integration allows Greenhouse to host the website for your job board. With this integration, you can customize the options available on the job board page, but you won't be able to configure anything more than what's displayed on the page.
When candidates apply using this integration, they will be linked to the jobs.greenhouse.io URL.
|Development time||Less than 1 hour|
|Customization||Add a logo, job posts with rich-text formatting, and custom questions.|
|Example||Check out Harry's for an example of this configuration.|
Embed a Greenhouse job board in your website
This integration allows candidates to apply for a job directly on your website. You can also change the job board's appearance using custom code.
Embedding your job board in your website makes the job board look like a natural part of your careers page.
|Development time||1 hour-1 day|
|Customization||All customizations from Option 1, plus the ability to add your own custom CSS to style the embedded job board to match your site's unique look and feel|
|Example||Check out Bark & Co for an example of this configuration.|
Embed an API-driven job board in your website and host job applications with Greenhouse
In an API-driven board, the look-and-feel (or "styling") is controlled by your developers, but the actual web page is controlled by Greenhouse. However, with this integration, the application form (the fields candidates have to complete) are still hosted by Greenhouse and will be listed under a jobs.greenhouse.io URL.
|Development time||2-4 days|
|Customization||All customizations from Option 1, plus, all the raw data to you build any style of job board that you like|
|Example||Check out Braze for an example of this configuration.|
Embed an API-driven job board and application form in your website
This integration option contains all the benefits of the previous option, but candidates will also be able to apply directly on your organization's site. If needed, this option can be configured to have the application fields and the job posting displayed on the same page.
|Development time||3-5 days|
All customizations from Option 1 & Option 3, plus greater flexibility in rendering your job description via our API
|Example||Check out Flatiron Health for an example of this configuration (with the job description pulled from the API).|
Create a fully API-driven job board
In a completely API-driven approach, your web development team has complete control to configure a fully customized application experience. This option is only recommended to customers who want to create and maintain a custom job board.
Remember, since the job board is completely custom, things like error handling, spam prevention, and source tracking must be configured by your developers.
|Development time||5-8 days|
|Example||Check out HUGE for an example of this configuration.|