For customers of our Position Management module utilizing our ClearCo integration.
Our bidirectional integration allows you to create requisitions in Built, utilize our configurable approval flow, and then send the requisitions to ClearCo. You can also connect requisitions imported from ClearCo to positions in Built.
While any ClearCo 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.
Connecting Built and ClearCo
To begin implementing your integration, please contact your ClearCo account manager. After connecting Built to ClearCo, daily automatic imports will be enabled. You may also initiate a manual import from ClearCo at any time.
We recommend creating a Requisition custom field in ClearCo, allowing you to send Built position IDs for requisitions. To do this, click the Tools dropdown, then click Setup. Locate the Recruiting Setup section, click Custom Fields, select Requisition Custom Fields, and then select New Requisition Field. Enter the field name, “Built Position ID,” set the answer type to Single Field, and click Save and Submit.
Sending Built Requisitions to ClearCo
Built’s Customer Success Team will work with you to configure your integration. By default, requisition data sent from Built to ClearCo will include the information listed in the table 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.
Requisition Data Sent to ClearCo | ||
Built Field | Corresponding ClearCo Field | Required |
Department | Department | Yes |
EEOC Classification | EEO Type | No |
Employee Type | Employment Status | No |
External Req Status | Status | No |
Hiring Manager* | Hiring Manager | Yes |
Job Description | Job Description | Yes |
Location* | Office | Yes |
Recruiter* | Recruiter | Yes |
Req ID | Requisition ID | No |
Req Title | Job Title | No |
*To successfully send requisitions to ClearCo, field data sent from Built must already exist in your organization’s ClearCo account. If the data cannot be matched to an existing option in ClearCo, you will be prompted to select from the available options. For example, if a requisition’s department is identified as Sales in Built, a Sales department must also exist in ClearCo.
Notes about sending requisitions to ClearCo:
Requisitions in ClearCo can only have one assigned recruiter. If a requisition sent from Built has more than one assigned recruiter, a recruiter will automatically populate in ClearCo based on the first matching result. We recommend updating recruiters in ClearCo before sending Built requisitions.
Once a Built requisition is sent to ClearCo, only the requisition’s status in ClearCo will be automatically updated in Built. By default, the requisition’s status in ClearCo will be set to On Hold.
The ClearCo API does not currently support sending or importing the number of openings on a requisition.
Importing Requisitions from ClearCo
Refer to the table below to learn about the data requirements for manually or automatically importing requisitions from ClearCo.
Requisition Data Imported from ClearCo | |
|---|---|
Built Field | Corresponding ClearCo Field |
Department | Department |
Hiring Manager | Hiring Manager |
Location | Office |
Pay Range | Salary Range |
External Req ID | Requisition ID |
External Req Status | Status |
Req Title | Job Title |
Managing Your Integration and Imported Requisitions
Once your integration is connected, you can manage your settings and initiate manual imports as needed. Connect imported job requisitions to positions in Built to ensure complete, accurate data and improve planning.
Please contact our Customer Success Team for additional assistance.