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

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

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

{% hint style="info" %}
That’s it! Share the API key with your Data Integration Manager or Customer Success Manager to get started!
{% endhint %}


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.