Connecting Ashby to Built

Prev Next

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:

  1. Log in to Ashby.

  2. In the main navigation, click Admin.

  3. In the Admin panel on the left, click Integrations to expand that section, then click Integrations.

  4. Search for and select Built.

  5. Click + Create API key for Built.

  6. 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.

  1. Log into Built.

  2. At the top of the main navigation, click your company name, then click Integrations.

  3. When the Integration page opens, locate the Ashby tile and click the + Add Integration button.

  4. Enter the API Key generated in Ashby.

  5. 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:

  1. Navigate to the Integrations page.

  2. Locate the Ashby tile, click the three-dot menu, then click Remove Integration.

  3. Click Remove to confirm this action.

    Future imports cannot be initiated after disconnecting your integration.

Please contact our Customer Success Team for additional assistance.

Additional Resources

Creating and Managing Requisitions

Supported API Integrations