For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrating with Ashby

Prerequisites

Ashby Setup

Create a new API Key

Prerequisites

To connect Ashby to Drivetrain, you need:

  • An active Ashby account

  • Admin privileges on Ashby

  • Admin privileges in Drivetrain

Ashby Setup

Drivetrain supports integration with Ashby via API from a read-only external admin user account.

To get started you would need to create an API Key on Ashby for Drivetrain with read-only administrative access.

Create a new API key

  1. Sign in to Ashby and click Admin in the top navigation bar and click on Navigate to Integrations in left side bar.

  2. Click on API keys

  1. Click "+ New" in the upper right corner

  1. Add a name for the new API key as "Drivetrain Integration", then click "Create API Key"

  2. Grant the following permissions to your API key

Permission
Required at minimum
Explanation

Jobs: Read

Y

Candidates: Read

Y

Candidates: Write

N

Not needed, we don't write back to Ashby

Interviews: Read

Y

Hiring Process Metadata: Read

Y

Hiring Process Metadata: Write

N

Not needed, we don't write back to Ashby

Organization: Read

Y

Offers: Read

Y

  1. Click on Save and Continue. Copy the API key and store it in a secured document.


Drivetrain Setup

After generating your Ashby API key (above), add Ashby as a data source in your Drivetrain instance. You must be a Drivetrain administrator to add a data source.

Step 1: Go to the Data page and add a data source

  1. Sign in to your Drivetrain instance as an administrator.

  2. In the left navigation, click Data.

  3. At the top of the data sources panel, click the + (Add data source) button.

Step 2: Select the Ashby connector

  1. In the Connect a datasource window, type Ashby in the search bar (or open the HRIS & ATS category).

  2. Click the Ashby connector card.

Step 3: Confirm administrator access

  1. The Ashby connection window opens with the message "Administrator role required."

  2. Click I am an admin to continue.

Step 4: Enter your Ashby API key

  1. When prompted, paste the Ashby API Key you generated in the Ashby Setup section above.

  2. Click Next to validate the key and create the connection.

Step 5: Finish setup

  1. Once the key is validated, the connection is created and you are returned to the Data page.

  2. Ashby now appears in your list of connected data sources and begins syncing.

  3. When the sync completes, your Ashby data is available across Drivetrain.

If you have any questions or run into any issues during setup, please contact your customer success manager for assistance.

Last updated

Was this helpful?