For customers of our Position Management module integrating with Greenhouse.
Our bidirectional integration allows you to create requisitions in Built, utilize our configurable approval flow, and then send the requisitions to Greenhouse. You can also connect requisitions imported from Greenhouse to positions in Built.
To create a Harvest API key for the Greenhouse + Built integration:
To generate an API key, you must have the developer permission to manage ALL organization's API Credentials.
Log in to your Greenhouse account, click 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.
In the Create New Credential box, make the following selections:
API Type: Harvest
Partner: Built (optional)
Description: Built Harvest API KeyClick 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.
You won’t be able to view the API key after clicking I have stored the API Key in the next step. 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.
Click I have stored the API Key.
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:
Only Company Admins and HR Admins can manage company settings. Learn more about managing user roles and 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 Greenhouse in the list of integrations.
Paste in your Harvest API key
Click Connect. After connecting to Greenhouse, daily automatic imports will be enabled. You may also initiate a manual import at any time.
Sending Requisitions to Greenhouse
Refer to the table below to learn about the data requirements for sending requisitions to Greenhouse:
Once a Built requisition is sent to Greenhouse, only the requisition’s status in Greenhouse will be automatically updated in Built.
Importing Requisitions from Greenhouse
Refer to the table below to learn about the data requirements for manually or automatically importing requisitions from Greenhouse:
To configure the frequency and notifications for automatic imports:
Navigate to Company Settings > Imports.
Locate the Greenhouse Import Settings section and click the Edit button.
If not yet enabled, select Yes to enable automatic imports.
Select your desired import frequency.
Enter an email address for automated import notifications.
To disable automatic imports:
Navigate to Company Settings > Imports.
Locate the Greenhouse Import Settings section and click the Edit button.
In the Enable Automatic Imports field, select No.
To manually import job requisition data from Greenhouse:
From Built’s main menu, navigate to the Recruiting page.
Click the import icon in the upper right corner of the page.
Once the import is complete, click View Requisitions.
To connect job requisitions to positions in Built:
Navigate to Positions > Requisitions.
To find the requisition you would like to connect to a position, filter the list by the requisition status, or use the search field. To view a requisition, click the job requisition ID or title in the table.
Click the Connect Position button in the Position ID column.
Enter the title or position ID of the position you’d like to connect.
Click Save.
You can view data for requisitions connected to Built positions on the Positions table and Positions Reports by enabling the following data options: Req ID, Req Status, External Req ID, and External Req Status. Data will not be displayed for Built requisitions with Denied, Canceled, or Closed statuses. Data will not be displayed for connected imported requisitions with Filled, Canceled, Rejected, or Closed statuses.
To disconnect the Greenhouse integration in Built:
Once you have disconnected Greenhouse from your Built account, future imports cannot be initiated.
Navigate to Company Settings > Integrations.
Click Greenhouse in the list of integrations.
Click the Deactivate button.
Click OK.
Please contact our Customer Success Team for additional assistance.