---
title: "Ashby"
description: "Hole eingestellte Ashby-Kandidatinnen und -Kandidaten als künftige Mitarbeitende nach Pyn, damit Pre-Boarding-Flows vor dem ersten Tag starten können."
sidebar:
  label: Übersicht
  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
---

Die Ashby-Integration liest Kandidatinnen und Kandidaten mit einer Bewerbung im Status „hired“ und einem gültigen Angebot mit Startdatum (ein angenommenes Angebot wird bevorzugt) und legt sie als künftige Mitarbeitende an, mit Startdatum, Jobtitel, Abteilung, Standort und Hiring Manager. Ein Pre-Boarding-Flow mit Trigger auf das Startdatum kann sie dann unter einer privaten Adresse erreichen, bevor ihr Arbeitskonto existiert.

## Bevor du beginnst

- Du bist Admin oder Owner in Pyn.
- Ein Ashby-Admin erstellt unter **Admin > API Keys** einen API-Schlüssel mit Lesezugriff auf **Candidates**, **Offers** und **Organization**. Lesezugriff auf **Jobs** ist optional und übernimmt den am Job statt an der Bewerbung gesetzten Hiring Manager. Um Neueinstellungen für vertrauliche Jobs einzuschließen, erlaube zusätzlich den Zugriff auf vertrauliche Jobs und Projekte.

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

## Verbinden

1. Öffne in Pyn **Settings** in der linken Navigation, dann **Available** unter **Integrations**.

2. Wähle die Kachel **Ashby**. Der Dialog **Connect to Ashby** öffnet sich.

3. Füge den **API Key** ein.

4. Wähle **Connect**. Der Dialog zeigt „Validating that API key...“, während Pyn ihn prüft.

5. Bei Erfolg lautet die Meldung „Your Ashby integration has been added to Pyn. It will take a minute or two for candidate data to be pulled from Ashby.“

Fehler, die der Dialog zeigen kann: „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.“

## Was synchronisiert wird

Pyn aktualisiert etwa einmal pro Stunde aus Ashby. Für jede Bewerbung im Status „hired“ liest es:

| Pyn-Eigenschaft | Aus Ashby |
| --- | --- |
| Anzeigename, rechtlicher Name | Der Name der Kandidatin oder des Kandidaten |
| Geschäftliche E-Mail, private E-Mail | Die geschäftlichen und privaten Kontakt-E-Mails |
| Startdatum | Das Startdatum der neuesten Angebotsversion |
| Jobtitel | Der Job der Bewerbung |
| Abteilung, Standort | Die Namen von Abteilung und Standort des Jobs |
| Führungskraft | Der Hiring Manager des Jobs (ein Ashby-User) |
| Zeitzone | Die Zeitzone der Kandidatin oder des Kandidaten |
| Eigene Felder | Jede Workspace-Erweiterung, die auf ein eigenes Ashby-Feld abgebildet ist, gelesen aus dem Angebot, dann der Bewerbung, dann der Person |

Neueinstellungen erscheinen im Directory bis zu ihrem Startdatum als **Upcoming**. Siehe [Synchronisierungsrhythmus und Abgleich](https://support.pyn.ai/de/integrations/sync-and-matching/) dafür, wie sie dem später eintreffenden HRIS-Datensatz zugeordnet werden.

## Testen

Öffne nach der ersten Aktualisierung [Employees](https://support.pyn.ai/de/directory/employees/) und wähle die Ansicht **Upcoming**: Aktuelle Neueinstellungen sollten mit ihrem Startdatum aufgeführt sein. Der Tab **History** der Integration zeigt jede Aktualisierung.

## Neu verbinden oder trennen

- **Reconnect** im Menü **...** öffnet **Reconnect to Ashby**, um einen neuen Schlüssel einzufügen. „Your Ashby integration has been updated.“ bestätigt es.
- **Deactivate** pausiert die Synchronisierung; **Activate** setzt sie fort.

## Fehlerbehebung

| Was du siehst | Was es bedeutet |
| --- | --- |
| History: „Error: Authentication failed, please reconnect“ | Der Schlüssel wurde in Ashby deaktiviert. Erstelle einen neuen und verbinde neu. |
| History: „Error: Insufficient Ashby permissions“ | Dem Schlüssel fehlt ein Lese-Scope. Erlaube Candidates, Offers und Organization. |
| Eine Neueinstellung fehlt | Das Angebot wurde abgelehnt, storniert oder zurückgezogen, hat kein Startdatum, oder der Job ist vertraulich und der Schlüssel kann ihn nicht sehen. |
| Hiring Manager leer | Erlaube Lesezugriff auf Jobs oder setze den Hiring Manager an der Bewerbung. |

## Verwandte Seiten

- [Integrations](https://support.pyn.ai/de/integrations/) für den Katalog.
- [Greenhouse](https://support.pyn.ai/de/integrations/greenhouse/) für die andere ATS-Integration.
- [Synchronisierungsrhythmus und Abgleich](https://support.pyn.ai/de/integrations/sync-and-matching/) dafür, wie ATS- und HRIS-Datensätze zusammengeführt werden.
- [Automations](https://support.pyn.ai/de/flows/automations/), um einen Pre-Boarding-Flow mit Trigger auf das Startdatum zu bauen.
