> For the complete documentation index, see [llms.txt](https://integrations.drivetrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-ashby.md).

# Integrating with Ashby

[Prerequisites](#prerequisites)

[Ashby Setup](#zenefits-setup)

[Create a new API Key](#add-a-new-user)

## Prerequisites

To connect Ashby to Drivetrain, you need:

* An active Ashby account
* Admin privileges on Ashby
* Admin privileges in Drivetrain

## Ashby Setup <a href="#zenefits-setup" id="zenefits-setup"></a>

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 <a href="#add-a-new-user" id="add-a-new-user"></a>

1. Sign in to Ashby and click **Admin** in the top navigation bar and click on Navigate to **Integrations** in left side bar.&#x20;
2. Click on **API keys**

<figure><img src="/files/D9H8DPsVh4POXnaFY5Ht" alt=""><figcaption></figcaption></figure>

3. Click "**+ New**" in the upper right corner

<figure><img src="/files/fWRxGlNougLMGgqklHtV" alt=""><figcaption></figcaption></figure>

4. Add a name for the new API key as "**Drivetrain Integration**", then click "**Create API Key"**
5. 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                   |                                          |

6. Click on Save and Continue. Copy the API key and store it in a secured document.&#x20;

***

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

<figure><img src="/files/Bsq8T5ef0wCaw18DODcl" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/x5lg2XSBwjCNLU2V2vUY" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/SEWHbtm78aYru9NkKHNh" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lXbk6UYIAMZE7PjoXvkE" alt=""><figcaption></figcaption></figure>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-ashby.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.