For customers of our Position Management module utilizing our Ashby integration.
Our bidirectional integration allows you to create requisitions in Built, utilize our configurable approval workflow, and then send the requisitions to Ashby. Connect imported requisitions to positions in Built to view them on your official chart and across configurable reports and metrics, improving visibility and planning.
While all Ashby customers 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.
Before connecting Built to Ashby, you must first generate an API key in Ashby:
Log in to Ashby.
In the main navigation, click Admin.
In the Admin panel on the left, click Integrations to expand that section, then click Integrations.
Search for and select Built.
Click + Create API key for Built.
Copy the API key displayed to your device's clipboard, which you will need to enter into Built to complete the integration setup.
To connect Built to Ashby:
Only Company Admins and HR Admins can manage integrations. Learn more about managing user roles and permissions.
Log into Built.
At the top of the main navigation, click your company name, then click Integrations.
When the Integration page opens, locate the Ashby tile and click the + Add Integration button.
Enter the API Key generated in Ashby.
Click Connect. Connecting your integration will start an initial requisition import and enable daily automatic imports. Configure your integration settings to reflect your organization’s import preferences and more.
Company Admins and HR Admins may initiate a manual import at any time by clicking the three-dot menu on the Ashby tile, then clicking Start Manual Import.
Sending Requisitions to Ashby
When sending requisitions to Ashby, you can choose whether to create a new job or create openings for an existing job. By default, requisition data sent from Built to Ashby 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 Ashby
Data Sent to Ashby | ||
Built Field | Corresponding Ashby Field | Required |
Department | Team | Yes |
Employee Type | Employment Type | Yes |
External Req Status | Job Status | No |
Hiring Manager | Hiring Manager | No |
Interview Plan | Interview Plan | Yes |
Location | Location | Yes |
Pay Grade (Min and Max) | Compensation Tier | No |
Requisition ID | Requisition ID | No |
Recruiter | Recruiter | No |
Title | Title | Yes |
Once a Built requisition is sent to Ashby, only the requisition’s status in Ashby will be automatically updated in Built.
Creating Openings in Ashby
Data Sent to Ashby | ||
Built Field | Corresponding Ashby Field | Required |
Position ID or Requisition ID* | Opening ID | No |
Department | Team | |
Employee Type | Employment Type | Yes |
— | Job | Yes |
Location | Location | |
— | Opening Status | Yes |
Title | Description | Yes |
For jobs with Closed or Archived statuses, creating openings changes the selected job’s status to Open. If an opening with the same ID already exists, it is reopened rather than duplicated.
*If the requisition is not connected to a position, the requisition ID will be sent instead.
Importing Requisitions from Ashby
Refer to the table below to learn about the data requirements for importing requisitions from Ashby. Once imported, you can connect requisitions to positions in Built. The initial import from Ashby only includes jobs with Draft and Open statuses.
Requisition Data Imported from Ashby | ||
Built Field | Corresponding Ashby Field | Required |
External Req Status | Job Status | Yes |
Department | Team | No |
External Req ID | Requisition ID** | Yes |
Hiring Manager | Hiring Manager | No |
Location | Location | No |
Reqs Filled | Closed or Filled Openings / Total Openings | Yes |
Title | Title | Yes |
**If customer requisition IDs are not enabled in Ashby, the Ashby job ID is used instead.
Connecting Imported Requisitions to Built Positions
Connecting imported job requisitions to positions in Built helps you ensure complete, accurate data.
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.
To disconnect your integration:
Navigate to the Integrations page.
Locate the Ashby tile, click the three-dot menu, then click Remove Integration.
Click Remove to confirm this action.
Future imports cannot be initiated after disconnecting your integration.
Please contact our Customer Success Team for additional assistance.