--- title: "Connecting Ashby to Built" slug: "connecting-ashby-to-built" status: "new" updated: 2026-11-17T12:32:36Z published: 2026-11-17T12:32:36Z canonical: "support.builtapp.com/connecting-ashby-to-built" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.builtapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Connecting Ashby to Built *For customers of our Position Management module utilizing our Ashby integration.* --- Our bidirectional integration allows you to [create requisitions](/v1/docs/creating-and-managing-requisitions) in Built, utilize our [configurable approval workflow](/v1/docs/configuring-requisition-approval-workflows-and-assigned-recruiters), and then [send the requisitions](/v1/docs/sending-requisitions-to-your-ats) to Ashby. Connect [imported requisitions](/v1/docs/data-sent-and-imported-via-your-adp-recruiting-management-integration#importing-requisitions) to positions in Built to [view them on your official chart](/v1/docs/applying-org-chart-visualization-tools#configuring-position-card-display-options) and across [configurable reports](/v1/docs/utilizing-your-organization-s-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*](/v1/docs/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](/v1/docs/configuring-how-built-handles-positions-for-imported-terminations-and-new-hires) 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](/v1/docs/sending-requisitions-to-your-ats) 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*](/v1/docs/responding-to-a-requisition#skipping-pending-approvals) *or* [*bypass a requisition’s approval process*](/v1/docs/sending-requisitions-to-your-ats#sending-requisitions-from-a-positions-info-panel) *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](/v1/docs/connecting-approved-requisitions-to-new-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 j**ob* *ID is* *used* *instead.* ## Connecting Imported Requisitions to Built Positions [Connecting imported job requisitions to positions](/v1/docs/connecting-approved-requisitions-to-new-positions#external-requisitions-created-in-your-ats) 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*](/v1/docs/utilizing-your-position-data) *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](/v1/docs/creating-and-managing-requisitions) [Supported API Integrations](/v1/docs/supported-api-integrations)