Customers can easily highlight internal jobs outside of Greenhouse without using an API by using iFrames to embed internal job boards on company sites.
Note: 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
Note: Embedding internal job boards through iFrames is only available to organizations using the new job board customization options.
You can locate iFrames for your internal job board in two ways:
Select from the URL
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."
Find in the Job Board Dev Center
Go to Configure > Job boards and posts, select the job board, and choose Board Settings under the ellipses icon. Select Dev Center in the left panel, 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. 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 can access a simple JSON representation of your company’s offices, departments, and published jobs. You can use this raw data to build careers pages with a unique look and feel, construct department-level pages, and other customization needed by your organization.
The board token when posting back to Greenhouse is internal
POST https://boards-api.greenhouse.io/v1/boards/internal/jobs/{id}