Integrate a job board with your careers page

Permissions: Basic users and above who can manage job board-related API credentials

Product tier: Available for all subscription tiers

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.

Note: Making a job board live is not the same as making a job post live. A job post must be live in order for candidates to apply.

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.

Note: You can switch job board integration types at any time. Work with your development team to make changes.

You can view detailed descriptions of the integration options in Greenhouse Recruiting. (Configure icon Configure-icon.png > 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 URL. 

Difficulty Very easy
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.

Difficulty Easy
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 URL.

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

Tip: Greenhouse Recruiting integrations Urban Pixels and Ironistic can help you create a unique job board tailored to your brand.

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.

Difficulty Moderate
Development time 3-5 days

All customizations from Option 1 & Option 3, plus greater flexibility in rendering your job description via our API

Note: This approach allows for greater stylistic customization and works well for single-page applications.

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.

Difficulty Most difficult
Development time 5-8 days
Customization Fully customizable
Example Check out Lemonade for an example of this configuration.

Additional resources

For integration option 1, contact Customer Support for help.

For integration options 2 through 5, refer to your development team for troubleshooting support.