---
title: "Ashby"
description: "Haal aangenomen kandidaten uit Ashby als aankomende medewerkers in Pyn binnen, zodat pre-boardingflows vóór dag één kunnen starten."
sidebar:
  label: Overzicht
  order: 0
area: integrations
feature: ashby
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - integrations
  - integrations/greenhouse
  - integrations/sync-and-matching
  - flows/automations
translation:
  source: integrations/ashby/index.mdx
  sourceSha: d7b66f45596ed73fca1ddce214dfa31498448362
---

De Ashby-integratie leest kandidaten met een aangenomen sollicitatie en een actueel aanbod met een startdatum (een geaccepteerd aanbod heeft de voorkeur) en maakt ze aan als aankomende medewerkers, met hun startdatum, functietitel, afdeling, locatie en hiring manager. Een pre-boardingflow met de startdatum als trigger kan hen dan op een persoonlijk adres bereiken voordat hun werkaccount bestaat.

## Voordat je begint

- Je bent admin of owner in Pyn.
- Een Ashby-beheerder maakt een API-sleutel aan onder **Admin > API Keys** met leesrechten op **Candidates**, **Offers** en **Organization**. Leesrechten op **Jobs** zijn optioneel en halen de hiring manager op die op de vacature staat in plaats van op de sollicitatie. Om ook aangenomen kandidaten voor vertrouwelijke vacatures mee te nemen, geef je ook toegang tot vertrouwelijke vacatures en projecten.

![Connect to Ashby asks for an API Key.](https://support.pyn.ai/media/integrations/ashby/integrations-ashby-connect.png)

## Koppelen

1. Open in Pyn **Settings** in de linkernavigatie, en dan **Available** onder **Integrations**.

2. Selecteer de tegel **Ashby**. Het dialoogvenster **Connect to Ashby** opent.

3. Plak de **API Key**.

4. Selecteer **Connect**. Het dialoogvenster toont "Validating that API key..." terwijl Pyn hem controleert.

5. Bij succes leest een melding "Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby."

Fouten die het dialoogvenster kan tonen: "Could not verify that API key — it appears to be invalid or deactivated." / "The API key is valid but lacks the permissions needed. Grant it read access to Candidates, Offers and Organization and try again." / "Enter an Ashby API key." / "An unexpected error occurred. Please check the API key and try again. If the error persists, contact support."

## Wat er wordt gesynchroniseerd

Pyn ververst ongeveer één keer per uur vanuit Ashby. Voor elke aangenomen sollicitatie leest het:

| Eigenschap in Pyn | Uit Ashby |
| --- | --- |
| Weergavenaam, officiële naam | De naam van de kandidaat |
| Zakelijk e-mailadres, persoonlijk e-mailadres | Het zakelijke en persoonlijke contactadres van de kandidaat |
| Startdatum | De startdatum van de laatste versie van het aanbod |
| Functietitel | De vacature van de sollicitatie |
| Afdeling, locatie | De namen van afdeling en locatie van de vacature |
| Manager | De hiring manager van de vacature (een Ashby-gebruiker) |
| Tijdzone | De tijdzone van de kandidaat |
| Aangepaste velden | Elke workspace-extensie die aan een aangepast Ashby-veld is gekoppeld, gelezen uit het aanbod, dan de sollicitatie, dan de kandidaat |

Aangenomen kandidaten verschijnen in de Directory als **Upcoming** tot hun startdatum. Zie [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor hoe ze worden gematcht met het HRIS-record dat later aankomt.

## Testen

Open na de eerste verversing [Employees](https://support.pyn.ai/nl/directory/employees/) en selecteer de weergave **Upcoming**: recent aangenomen kandidaten horen er met hun startdatum te staan. Het tabblad **History** van de integratie toont elke verversing.

## Opnieuw koppelen of ontkoppelen

- **Reconnect** in het menu **...** opent **Reconnect to Ashby** om een nieuwe sleutel te plakken. "Your Ashby integration has been updated." bevestigt het.
- **Deactivate** pauzeert het synchroniseren; **Activate** hervat het.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| History: "Error: Authentication failed, please reconnect" | De sleutel is in Ashby gedeactiveerd. Maak een nieuwe aan en koppel opnieuw. |
| History: "Error: Insufficient Ashby permissions" | De sleutel mist een leesrecht. Geef leesrechten op Candidates, Offers en Organization. |
| Een aangenomen kandidaat ontbreekt | Het aanbod is afgewezen, geannuleerd of ingetrokken, heeft geen startdatum, of de vacature is vertrouwelijk en de sleutel kan haar niet zien. |
| Hiring manager leeg | Geef leesrechten op Jobs, of stel de hiring manager in op de sollicitatie. |

## Gerelateerd

- [Integrations](https://support.pyn.ai/nl/integrations/) voor de catalogus.
- [Greenhouse](https://support.pyn.ai/nl/integrations/greenhouse/) voor de andere ATS-integratie.
- [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor hoe ATS- en HRIS-records samenkomen.
- [Automations](https://support.pyn.ai/nl/flows/automations/) om een pre-boardingflow op de startdatum te bouwen.
