There are several different ways to integrate your jobs in Greenhouse Recruiting with your organization's careers page.
All options provide comprehensive source and referral tracking, support for custom fields and the ability to upload your company logo. Each integration option varies in how much time it takes to set up and how many custom changes it supports.
Review this article with your development team to determine the best integration option for your organization.
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.
Before choosing an integration option, work with your team to determine your implementation timeline, the amount of web development resources you have and the desired "look and feel" of your job board.
Some requirements will limit your integration options. For example, if you want to use Google Analytics or other tracking pixels with your job board, you'll need to use option 5. If you want your job board to be ADA-compliant, you'll need to use option 4 or option 5.
You can view detailed descriptions of the integration options in Greenhouse Recruiting. (Configure icon > Dev Center > Careers Page Integration Options)
Click the How to integrate link to get more detailed instructions on how to set up each option.
Option 1: 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 Qovery for an example of this configuration.|
Option 2: 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 eduMe for an example of this configuration.|
Option 3: 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 Robinhood for an example of this configuration.|
Option 4: 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).|
Option 5: 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 Lemonade for an example of this configuration.|
For integration option 1, contact Customer Support for help.
For integration options 2 through 5, refer to your development team for troubleshooting support.