Customers can now easily highlight internal jobs outside of Greenhouse — without using an API. Internal jobs can now be hosted where employees already go for news and updates by using iFrames to embed internal job boards on company sites. Internal job post iFrames are only available to organizations using the new job board customization options.
Customers using legacy job boards can add their job posts to their internal site using the Harvest API and Job Board API.
iFrames
If you'd like to use iFrames to host an internal post outside of Greenhouse, first verify that you're using a new job board. Go to Configure Job Boards (Configure > Job boards).
To opt into new job boards, select Board settings. Toggle the New job board switch to "On" to enable the redesigned features.
Once you've verified that new job boards are on there are two ways you can enable iFrames for your internal job board.
1. Go to Configure > Dev Center > Configuring your job board, then choose your job board from drop-down.
Select the pencil to add your job board URL.
Once a message appears above the URL, click "Point tracking links to Greenhouse job boards."
2. Go to Configure > Job boards and posts, then select the job board you’d like to update. Next, go to Board settings > Dev center. Add your job board URL and click “Save.”
Once a message above the new URL appears, select “Update tracking links to the URL below.”
API-driven job board on your site with job applications hosted by Greenhouse
Greenhouse Recruiting's API allows your developers to pull a raw JSON feed of jobs, offices, and departments—while still letting you take advantage of the simplicity of the Greenhouse-hosted job application forms. This option is great for creating segmented job boards (by office or department), or for customers that need maximum stylistic flexibility for the job board. This option is most similar to Option 3 configuration for your external site.
1. Retrieve your jobs from Harvest API:
Use the following method: GET https://harvest.greenhouse.io/v1/job_poststo retrieve all of the job posts in your organization. Additionally, you can add a parameter to only query for "live" jobs. The external and internal values will let you determine whether or not a job is external, internal, or both.
2. Redirect candidates to Greenhouse:
If you would like to host the jobs but still have us manage the application process, you can redirect your employees to https://app.greenhouse.io/internal_job_board/applications/{{post_id}}
If your organization uses SSO to manage access to Greenhouse, you'll want to use the following structure https://{{subdomain}}.greenhouse.io/internal_job_board/applications/{{post_id}}
100% API-driven
When hosting an internal job board outside of Greenhouse that is 100% API-driven, Greenhouse will provide your organization with the data via our API and your developers can dynamically construct application forms. With this option, all error-handling, spam prevention, and source tracking will need to be handled by your development team. This option is most similar to Option 5 configuration for your external site.
1. Retrieve your jobs from Harvest API:
Use the following method GET https://harvest.greenhouse.io/v1/job_posts to retrieve all of the job posts in your organization. Additionally, you can add a parameter to only query for "live" jobs. The external and internal values will let you determine whether or not a job is external, internal, or both.
2. Host application form yourself and POST applicants to Greenhouse:
With Greenhouse Recruiting's Job Board API, you will have easy access to a simple JSON representation of your company’s offices, departments, and published jobs. Since we give you access to the raw data, you can build careers pages with a unique look and feel, construct department-level pages, and more!
We support JSONP callbacks, and have a POST method which can be used to build your own online job application form.
The board token you'll want to use when posting back to Greenhouse is internal
POST https://boards-api.greenhouse.io/v1/boards/internal/jobs/{id}