---
title: Ashby Integration
slug: ashby-integration
docTags: 
createdAt: 2024-05-01T01:04:56.652Z
---

:::hint{type="warning"}
This feature is currently in Beta.

We're really excited about it and it's already being used by multiple organizations.

Try it out and send feedback to the ChartHop team or directly to [product-feedback@charthop.com](mailto\:product-feedback@charthop.com).

### How to setup a Beta Feature

1. From the left sidebar, select **Admin,** then select **Labs**.
2. Use the switch to toggle on the feature, then press the **Save settings** button.
3. Read below for additional setup instructions and context about what will be activated when you save settings.
:::

The Ashby integration is a two-way sync that allows for the following:

- Outbound — ChartHop to Ashby — [Open Job ➡️ Opening](./#sync-an-open-job-in-charthop-to-an-opening-in-ashby)
  - ChartHop must be the source of truth for Open Jobs
- Inbound — Ashby to ChartHop — [Offer + Hired Candidate ➡️ Person in Filled Job](./#sync-an-offer-in-ashby-to-a-person-in-charthop)

The Ashby integration is developed by the Ashby team. You can view additional documentation from them: [here](https://ashbyhq.notion.site/Early-Access-ChartHop-5e55a07057a84482a69b44b913bbb996).

## Setup & API Keys

This integration uses two API keys — one for each direction of the sync. During setup, you'll be asked to provide both.

### ChartHop → Ashby API Key (generated by Ashby)

Ashby's setup flow will ask you to paste an API key into ChartHop. This key is generated in Ashby and authorizes ChartHop to connect to your Ashby account.

To generate this key:

1. Go to [app.ashbyhq.com/admin/api/keys](https://app.ashbyhq.com/admin/api/keys) in Ashby.
2. Create a new API key and copy it.
3. Paste it into the field shown during the ChartHop integration setup.
4. Continue following the remaining steps in [Ashby's setup documentation](https://ashbyhq.notion.site/Early-Access-ChartHop-5e55a07057a84482a69b44b913bbb996).

### Ashby → ChartHop API Key (generated by ChartHop)

ChartHop also generates its own API key, which Ashby uses to push data back to ChartHop (e.g., hired candidates). This key is generated automatically by ChartHop during the installation flow and is provided to Ashby as part of the setup.

:::hint{type="info"}
ChartHop's ability to connect directly to Ashby via AI is a newer, experimental capability. If you run into any issues, please contact support.
:::

## Sync an Open Job in ChartHop to an Opening in Ashby

1. Mark the hiring **Recruiting Status** as `Active` in ChartHop
2. Wait for the open to sync to Ashby (The sync runs every 5 minutes)
3. Look for the Job in the list of Openings in Ashby: [app.ashbyhq.com/openings](https://app.ashbyhq.com/openings)
4. The job will be imported with a status of `Approved` — move it to `Open` to start hiring.

::Image[]{src="https://api.archbee.com/api/optimize/CXAjUAezd9VEEVQBIYmdw/8Iq0Z29q8-kP_O9Q75IeS_screenshot-2024-04-30-at-91227-pm.png" size="52" width="792" height="454" position="center" darkWidth="792" darkHeight="454" showCaption="false"}

## Sync an Offer in Ashby to a Person in ChartHop

1. When creating the offer, add relevant fields that will be mapped to ChartHop.
2. After the candidate has accepted the offer and been marked as `Hired` in Ashby, they can be pushed to ChartHop from Ashby.
3. Wait for the sync from Ashby (The sync runs every 5 minutes)
4. View the new hire in ChartHop.

::Image[]{src="https://api.archbee.com/api/optimize/CXAjUAezd9VEEVQBIYmdw/_doyMfH3gKbClDKpV-PBm_screenshot-2024-04-30-at-91738-pm.png" size="66" width="1296" height="1090" position="center" caption="Setting ChartHop Information during offer" darkWidth="1296" darkHeight="1090" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/CXAjUAezd9VEEVQBIYmdw/mQYH844uUWRs5rQ8gwg1u_screenshot-2024-04-30-at-92456-pm.png" size="80" width="1142" height="396" position="center" caption="Adding candidate to ChartHop" darkWidth="1142" darkHeight="396" showCaption="true"}

## Syncing details & setup

- The sync will run every 5 minutes or whenever you push the sync button
- If you want to manually initiate the sync, press the sync button in Ashby. Running the App in ChartHop will not sync the app.
- The Ashby integration can pull any field *from* ChartHop and will automatically create new fields in Ashby. Simply mark the Checkbox to sync the field.
  - Only Custom fields in ChartHop can be synced.

::Image[]{src="https://api.archbee.com/api/optimize/CXAjUAezd9VEEVQBIYmdw/v_o2WVchmgGRI_2iFWa2n_screenshot-2024-04-30-at-94142-pm.png" size="66" width="2344" height="1200" position="center" caption="ChartHop App Setup in Ashby" darkWidth="2344" darkHeight="1200" showCaption="true"}