---
title: Integrating with Ashby
slug: integrating-with-ashby
icon: 🟪
docTags: 
createdAt: 2025-08-18T17:32:40.181Z
---

This guide covers:

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
- [Creating an API Key](https://docs.pin.com/integrating-with-ashby#creating-an-api-key)
- [Connecting Ashby to Pin](https://docs.pin.com/integrating-with-ashby#connecting-ashby-to-pin)
- [Syncing candidates to Ashby](https://docs.pin.com/integrating-with-ashby#syncing-candidates-to-ashby)
- [When candidates sync to Ashby](https://docs.pin.com/integrating-with-ashby#when-candidates-sync-to-ashby)
- [Checking if a candidate synced to Ashby](https://docs.pin.com/integrating-with-ashby#checking-if-a-candidate-synced-to-ashby)
:::

:::VerticalSplitItem
- [Manually syncing a candidate to Ashby](https://docs.pin.com/integrating-with-ashby#manually-syncing-a-candidate-to-ashby)
- [Candidate data synced to Ashby](https://docs.pin.com/integrating-with-ashby#candidate-data-synced-to-ashby)
- [How Pin checks for duplicates in Ashby](https://docs.pin.com/integrating-with-ashby#how-pin-checks-for-duplicates-in-ashby)
- [Source candidates from Ashby](https://docs.pin.com/integrating-with-ashby#source-candidates-from-ashby)
:::
::::

***

# Creating  an API Key

To connect Pin with Ashby, you’ll first need to create an API key in Ashby. You can follow [Ashby’s guide](https://ashbyhq.notion.site/How-do-I-generate-an-API-key-58d3409382014a3d80c3b08e982644d7) for step-by-step instructions on generating an API key.

When creating the API key, make sure it includes the following endpoint permissions required by Pin:

- **Jobs:** Read
- **Candidates:** Read & Write
- **Hiring Process Metadata: **Read
- **Organization:** Read
- **Api Keys:** Read

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/gPac8NsZzw6uDLU1a6hbB_screenshot-2026-10-19-at-92952-am.png)

***

# Connecting Ashby to Pin

1. Navigate to **Settings -> ATS Integration** and **select Ashby** from the list. 
2. **Enter your Ashby API Key** in the API key field. 
3. After entering your API key, the integration will be connected.

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/yZkVyw2ARlIdoukWoDxmd_image.png)

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/BM06VpI0yb_I4hvjhv66d_image.png)

***

# Syncing candidates to Ashby 

To sync candidates from each job in Pin to a specific job in Ashby: 

1. Go to **Job Settings -> Position Details**.
2. Scroll to the **ATS Integration **section.
3. Choose when to sync candidates by selecting one of the following triggers:
   - Never
   - Contact information is found
   - They receive their first message
   - They reply to an email
   - They reply to an email and are interested
4. Select the Ashby job you want to sync candidates to. 

Once you've selected your preferred trigger, Pin will automatically update the settings and sync candidates to the selected job in Ashby based on the chosen trigger.

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/-KBDOMHnOqx0b9q1iavMB_image.png)

:::hint{type="warning"}
**Reminder:** You’ll need to **set up the syncing for each job** you want to send from Pin to Ashby in the Position Details tab within the Job Settings.We recommend **setting up the job sync before adding candidates to Outreach**. This ensures candidates sync correctly to the job without issues.

If you prefer not to sync candidates to a job, you can still set up a trigger and leave the job field empty.
:::

***

# When candidates sync to Ashby

Once the selected trigger occurs, candidates will sync to Ashby within a few minutes.

For example: if you choose the trigger “Export candidates when contact information is found”, the candidate will automatically sync to Ashby a few minutes after being added to Outreach.

***

# Checking if a candidate synced to Ashby 

To confirm if a candidate has synced to Ashby, you can open their profile in Pin. If you see the Ashby logo, this means that they’ve been successfully synced. Clicking the logo will take you directly to their profile in Ashby.

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/mD_EK495j_OBNRIhRKwrq_image.png)

***

# Manually syncing a candidate to Ashby 

If the candidate hasn’t synced yet:

1. Select the candidate in Pin.
2. Click **“Export to ATS”**. 
3. Choose the Ashby job you want to sync the candidate to, then** click “Export” **to complete the sync.
4. After exporting, refresh the page, and you should now see the Ashby logo appear on their profile.

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/WwDWoB3Bh8eOwD5vqvGPt_image.png)

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/H3DUMvpBavTnj_WwbC5jB_image.png)

:::hint{type="warning"}
**Important:** 

- Once a candidate has synced to Ashby, their contact information cannot be re-synced. If some information did not sync, you’ll need to **manually update** that candidate’s profile in Ashby.
- The **"Export to ATS" button **only works for candidates who haven’t already synced to Ashby. If an integration was connected after the selected trigger, Pin won’t retroactively sync those candidates. In that case, use the "Export to ATS" button to sync them over.
:::

***

# Candidate data synced to Ashby 

The following candidate data will sync to Ashby from Pin:

1. Full name
2. Email
3. Phone number
4. LinkedIn profile URL
5. Location (city, state, country)
6. Current and previous roles
7. Education
8. A Pin generated resume PDF
9. If the candidate was sourced from Pin
10. Which team member sourced the candidate

:::hint{type="info"}
**Note:** All candidates will automatically sync into Ashby as** leads**. 
:::

***

# How Pin checks for duplicates in Ashby

Pin runs a check before syncing whenever a candidate is added to Outreach to prevent duplicate profiles. For Ashby, duplicates are checked against:

- **Email address**
- **LinkedIn URL**

If a match is found on either field, Pin will not create a new candidate profile in Ashby.

***

# Source candidates from Ashby

After connecting Ashby to Pin, you can use the **“ATS Candidates” filter** to include or exclude candidates from your ATS when searching for candidates. 

![](https://api.archbee.com/api/optimize/JtqPsvk-s0xQ7dgMBVpor/rpkHJMmkETFYj88idyMi0_image.png)