---
title: Integrating with Kortivity
slug: integrating-with-kortivity
icon: 🟠
createdAt: 2025-05-07T19:31:17.225Z
---

This guide covers:

::::VerticalSplit{layout="middle"}
:::VerticalSplitItem
- [Connecting Kortivity to Pin](https://docs.pin.com/integrating-with-kortivity#connecting-kortivity-to-pin)
- [Syncing candidates to Kortivity](https://docs.pin.com/integrating-with-kortivity#syncing-candidates-to-kortivity)
- [When candidates sync to Kortivity](https://docs.pin.com/integrating-with-kortivity#when-candidates-sync-to-kortivity)
- [Checking if a candidate synced to Kortivity](https://docs.pin.com/integrating-with-kortivity#checking-if-a-candidate-synced-to-kortivity)
:::

:::VerticalSplitItem
- [Manually syncing a candidate to Kortivity](https://docs.pin.com/integrating-with-kortivity#manually-syncing-a-candidate-to-kortivity)
- [Candidate data synced to Kortivity](https://docs.pin.com/integrating-with-kortivity#candidate-data-synced-to-kortivity)
- [How Pin checks for duplicates in Kortivity](https://docs.pin.com/integrating-with-kortivity#how-pin-checks-for-duplicates-in-kortivity)
- [Add Kortivity candidates to Pin](https://docs.pin.com/integrating-with-kortivity#add-kortivity-candidates-to-pin)
:::
::::

***

# Connecting Kortivity to Pin

1. Navigate to **Settings -> ATS Integration** and **select Kortivity** from the list. 
2. **Enter your API URL of your Kortivity instance, username and password** in the fields. You can find the API URL in the web address bar. By default it’s [https://k7y.app](https://k7y.app). 
3. After entering this information, the integration will be connected.

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

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

***

# Syncing candidates to Kortivity

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

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 Kortivity 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 Kortivity based on the chosen trigger.

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

:::hint{type="warning"}
**Reminder:** You’ll need to **set up the syncing for each job** you want to send from Pin to Kortivity 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 Kortivity

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

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

***

# Checking if a candidate synced to Kortivity

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

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

***

# Manually syncing a candidate to Kortivity

If the candidate hasn’t synced yet:

1. Select the candidate in Pin.
2. Click **“Export to ATS”**. 
3. Choose the Kortivity 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 Kortivity logo appear on their profile.

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

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

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

- Once a candidate has synced to Kortivity, their contact information cannot be re-synced. If some information did not sync, you’ll need to **manually update** that candidate’s profile in Kortivity.
- The **"Export to ATS" button **only works for candidates who haven’t already synced to Kortivity. 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 Kortivity

The following candidate data will sync to Kortivity from Pin:

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

***

# How Pin checks for duplicates in Kortivity

Pin runs a check before syncing whenever a candidate is added to Outreach to prevent duplicate profiles. For Kortivity, 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 Kortivity.

***

# Add Kortivity candidates to Pin 

To add Kortivity candidates to Pin, export them from Kortivity as a CSV, then upload that file to the relevant job in Pin. To avoid import errors, you can download and use Pin’s CSV template, and ensure your column headers and data formats match the template. You can download the CSV template [here](https://docs.google.com/spreadsheets/d/1G4YFId8ym0uaO4yAohala9Zchi790U0KWTF4WAX5N9g/edit?usp=sharing). 

:::hint{type="info"}
**Note:** The “ATS Candidates” search filter is not supported on Kortivity. The only way to add Kortivity candidates to Pin is via CSV import.
:::