For customers new to our Greenhouse integration.

If your organization uses Greenhouse for applicant tracking, you can easily import your requisitions from Greenhouse directly into your Built account. This integration with the Built Position Management module will allow you to connect requisitions to open positions on your org chart.

To create a Harvest API key for the Greenhouse Recruiting + Built integration:

Note: To generate an API key, you must have the developer permission Can manage ALL organization's API Credentials.

Log in to your Greenhouse account, click on the Configure icon, and select Dev Center on the left.
Select API Credential Management in the Dev Center.
From the API Credential Management page, click Create New API Key to generate the API key for Built for Teams.
In the Create New Credential box, make the following selections:
API Type: Harvest
Partner: Built for Teams (optional)
Description: Built for Teams Harvest API Key
Click Manage Permissions.
Click Copy to save your API key to your clipboard. Store the API key in a secure location to provide to Built in the next step.
Click I have stored the API Key once you have copied and saved the key.
Note: You won’t be able to view the API key after clicking I have stored the API Key. If you lose your API key or need to access it later, you’ll need to generate a new key and provide it to Built.
Select the checkboxes next to each permission box to associate it with the API key. The following permissions are needed for the Built integration: Jobs > Get: List Jobs.
Click Save.

To connect Built and Greenhouse:

Note: Only Company Admins can manage company Integrations settings. To learn more, please refer to: Understanding User Roles & Permissions.

Log into your Built account.
Click your company name at the top of the main navigation, then click Company Settings.
Click the Integrations tab.
Click the Greenhouse hyperlink in the list of integrations.
Paste in your Harvest API key
Click the Connect button.

To manually import job requisition data from Greenhouse:

After connecting to Greenhouse, your data will be imported automatically and daily automatic imports will be enabled. You may also initiate a manual import from Greenhouse at any time from the Job Requisitions page.

Navigate to Positions > Job Requisitions.
Click Import.
Once the import is complete, click View Job Requisitions.

To connect job requisitions to positions in Built:

Navigate to Positions > Job Requisitions.
To find the requisition you would like to connect to a position, filter the list by the status of the requisition, or use the search field. To see more details about a certain requisition, click the hyperlinked job requisition name or job requisition # in the table.
Click the Connect Position button in the Position ID column.
Enter the title or position ID of the position.
Click Save.

Configuring Automatic Imports

Automatic imports are enabled by default.

To configure the frequency and notifications for automatic imports:

Navigate to Settings > Imports.
Click Edit in the section titled GREENHOUSE IMPORT SETTINGS.
In the Enable Automatic Imports field, choose Yes.
Select your desired Import Frequency.
Enter an email address where the system can send a notification email each time the automated import process completes.

To disable automatic imports:

Navigate to Settings > Imports.
Click Edit in the section titled GREENHOUSE IMPORT SETTINGS.
In the Enable Automatic Imports field, choose No.

To disconnect the Greenhouse integration in Built:

Once you have disconnected Greenhouse from your Built account, you will no longer be able to view or edit the data in the Job Requisitions table and no future imports will take place.

Navigate to Settings > Integrations.
Click the Greenhouse hyperlink in the list of integrations.
Click the Deactivate button.
Click OK.

Please contact our customer success team for additional assistance.