For customers of our Position Management module integrating with Greenhouse.
Our bidirectional integration allows you to create requisitions in Built, utilize our configurable approval workflow, and then send the requisitions to Greenhouse. You can also connect requisitions imported from Greenhouse to positions in Built.
While any Greenhouse customer can enable the integration, only customers of our Position Management module can access the Requisitions table to create and manage requisitions in Built. Customers not subscribed to the Position Management module can only visualize imported requisitions on the org chart.
To connect Built to Greenhouse:
Only Company Admins can configure company settings. Learn more about managing user roles and permissions.
Click your company name at the top of the main navigation, then click Company Settings.
Click the Integrations tab.
If the Integrations tab is not immediately visible, click the More dropdown.
In the table, locate and click the Greenhouse hyperlink.
Click the Connect button.
Ensure you’re logged into Greenhouse, then complete the authorization step.
Connecting your integration will start an initial requisition import and enable daily automatic imports. You may also initiate a manual import at any time. Imported requisition data will not update connected positions in Built.
Configuring Your Integration Preferences
Once you connect your integration, you can configure your integration settings in Built.
For Greenhouse Advanced/Expert customers: We recommend creating an opening custom field in Greenhouse, allowing you to send Built position IDs for requisitions. To do this, click the configure icon, then click Custom Options. Locate the Company custom fields section, click Openings, then click Add field. Enter the field name, “Built Position ID”, click the Field type dropdown to select Short textbox, and click Save.
Sending Requisitions to Greenhouse
When sending requisitions to Greenhouse, you can choose whether to create a new job or openings for an existing job. By default, requisition data sent from Built to Greenhouse will include the information listed in the tables below. Alternatively, you can request a custom dataset to meet your organization’s needs.
While our requisition approval workflows help your team ensure the appropriate approvals, admins can skip pending approvers or bypass a requisition’s approval process when flexibility is needed.
Creating Jobs in Greenhouse
Data Sent to Greenhouse | |
Built Field | Corresponding Greenhouse Field |
External Req Status | Job Status |
Department | Department |
Greenhouse Template | Job Template |
Location | Office |
Number of Positions | Openings |
Req ID | Requisition ID |
Title | Internal Job Name |
Once a Built requisition is sent to Greenhouse, only the requisition’s status in Greenhouse will be automatically updated in Built.
Creating Openings in Greenhouse
Data Sent to Greenhouse | |
Built Field | Corresponding Greenhouse Field |
Req ID | Opening ID |
{Date the requisition is sent to Greenhouse} | Open Date |
Built Position ID | Built Position ID (Opening Custom Field*) |
Importing Requisitions from Greenhouse
Refer to the table below to learn about the data requirements for manually or automatically importing requisitions from Greenhouse:
Requisition Data Imported from Greenhouse | |
Built Field | Corresponding Greenhouse Field |
External Req Status | Job Status |
Department | Department |
External Req ID | Requisition ID |
Greenhouse Template | Job Template |
Hiring Manager | Hiring Manager |
Location | Office |
Reqs Filled | Openings |
Title | Internal Job Name |
Connecting Imported Requisitions to Built Positions
Connecting imported job requisitions to positions in Built helps you ensure complete, accurate data and improved planning.
You can view data for requisitions connected to Built positions on the Positions table and Position Management 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 a Closed status.
Please contact our Customer Success Team for additional assistance.