---
title: "HiBob"
description: "Synchronisiere Mitarbeitende aus Bob per Anmeldung oder mit einem Service User, samt Führungskraft, HRBP, Buddy, Ende der Probezeit und den eigenen Feldern, die du zuordnest."
sidebar:
  label: Übersicht
  order: 0
area: integrations
feature: hibob
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-06"
audience: admin
related:
  - integrations
  - integrations/hibob/field-mapping
  - integrations/hris-fields
  - integrations/sync-and-matching
  - directory/employees
intercom:
  - id: "16838927"
    title: Connect to HiBob (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16838927-connect-to-hibob-pyn-2
    note: replaces
  - id: "16814957"
    title: Connect to HiBob (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16814957-connect-to-hibob-pyn-2
    note: replaces
translation:
  source: integrations/hibob/index.mdx
  sourceSha: e0f0fbcfd3f208c9088f4b02b10dabc115c1a0e2
---

Die HiBob-Integration liest Personen aus Bobs API und hält das Directory aktuell: Namen, geschäftliche und private E-Mail, Start- und Austrittsdaten, Ende der Probezeit, Abteilung, Titel, Site, Führungskraft, HRBP und, wenn du ein eigenes Feld dafür hast, Buddy. Pyn liest nur; es schreibt nie nach Bob.

## Bevor du beginnst

- Du bist Admin oder Owner in Pyn.
- Wähle, wie du verbindest. **Connect with HiBob** meldet dich bei Bob an und autorisiert Pyn. **Use a service user instead** erwartet eine Bob-**Service User ID** und ein **API Token**, die ein Bob-Admin unter **Settings > Integrations > Service Users** anlegt.
- Gib dem Service User oder deinem eigenen Konto Lesezugriff auf die Bob-Kategorien, die die Felder enthalten, die Pyn liest: About, Address (Stadt, Land und Postleitzahl), Basic Info, Employment, Home (private E-Mail), Jobs, Lifecycle, Payroll > Employment (Vertrag), Personal (kurzes Geburtsdatum) und Personal Contact Details, für Mitarbeitende einschließlich Pre-Hires und ausscheidender Personen.

![Connect to HiBob offers a HiBob sign-in or a service user ID and token.](https://support.pyn.ai/media/integrations/hibob/integrations-hibob-connect.png)

## Verbinden

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

2. Wähle die Kachel **HiBob**. Der Dialog **Connect to HiBob** öffnet sich: „You will be redirected to HiBob to authorize Pyn to access your company's employee data.“

3. Zum Anmelden wähle **Connect with HiBob**, autorisiere Pyn in Bob und kehre zurück.

4. Um stattdessen einen Service User zu nutzen, wähle **Use a service user instead**, füge **Service User ID** und **API Token** ein und wähle **Connect**. Der Dialog zeigt „Validating those credentials...“

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

Fehler, die der Dialog zeigen kann: „Could not verify the credentials — the service user ID or token appears to be invalid.“ / „The credentials are valid but the service user lacks the permissions needed to read employees. Grant the service user people-read access in Bob.“ / „An unexpected error occurred. Please check the credentials and try again. If the error persists, contact support.“ Die letzte ist auch das, was **Connect with HiBob** zeigt, wenn Pyn die Anmeldung nicht starten kann.

## Was synchronisiert wird

Pyn aktualisiert etwa einmal pro Stunde aus Bob und hält jeden Lauf unter **History** fest. Der Tab **Advanced** listet **Fields in Report**: die Bob-Feld-IDs, die dein Tenant zurückgegeben hat, und für wie viele Personen; sieh dort nach, bevor du ein Feld für nicht verfügbar hältst.

| Pyn-Eigenschaft | Aus Bob |
| --- | --- |
| Anzeigename, rechtlicher Name | Anzeigename oder Vorname und Nachname |
| Geschäftliche E-Mail, private E-Mail | E-Mail und private E-Mail |
| Startdatum, Betriebszugehörigkeitsdatum | Startdatum; Betriebszugehörigkeit aus dem ursprünglichen Startdatum, sonst dem Startdatum |
| Austrittsdatum, Ende der Probezeit | Internes Austrittsdatum und internes Ende der Probezeit |
| Abteilung, Jobtitel, Standort | Abteilung, Titel und Site aus Work (ersatzweise die Stadt der Adresse) |
| Führungskraft | Reports-to, abgeglichen über Bob-ID oder Mitarbeitenden-ID im Unternehmen |
| HRBP | Das Feld `employee.hrbp` |
| Buddy | Das eigene Feld, das bei der Integration als Buddy-Feld benannt ist, eingerichtet mit dem Pyn-Support |
| Geburtstag, Land, Postleitzahl, Zeitzone | Kurzes Geburtsdatum und Adresse; Zeitzone aus Land und Postleitzahl |
| Vertragsart, Arbeitsort und weitere eigene Spalten | Workspace-Erweiterungen, die auf eine Bob-Feld-ID abgebildet sind |

Siehe [HiBob-Feldzuordnung](https://support.pyn.ai/de/integrations/hibob/field-mapping/) für die Bob-Feld-ID hinter jeder Eigenschaft und was du prüfst, wenn eine fehlt, und [HRIS-Felder](https://support.pyn.ai/de/integrations/hris-fields/) für die Matrix.

## Testen

Öffne die Kachel HiBob unter **Installed** und prüfe **History** auf eine erfolgreiche Aktualisierung, dann öffne [Employees](https://support.pyn.ai/de/directory/employees/) und bestätige Startdaten, Titel und Führungskräfte.

## Neu verbinden oder trennen

- **Reconnect** öffnet **Reconnect to HiBob** mit denselben zwei Optionen. Nachdem du in Bob ein Service-User-Token rotiert hast, fügst du hier das neue **API Token** ein. „Your HiBob integration has been updated.“ bestätigt es.
- **Deactivate** stoppt die Synchronisierung; **Activate** setzt sie fort.

## Webhook

In Workspaces, in denen der HiBob-Webhook aktiviert ist, hat das installierte HiBob-Panel einen Tab **Webhook**, sodass Bob Pyn über Änderungen an Mitarbeitenden informieren kann, sobald sie passieren. Du legst den Webhook in Bob mit einer Adresse an, die Pyn dir gibt, und fügst Bobs Signing Secret anschließend in Pyn ein.

1. Öffne die Kachel HiBob unter **Installed** und wähle den Tab **Webhook**. Der Hinweis lautet „Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync.“ Wähle **Set Up Webhook**.

2. Der Tab zeigt jetzt die Adresse, an die gepostet wird, mit **Copy URL**. Lege in Bobs Webhook-Einstellungen einen Webhook an, der an diese URL postet.

3. Abonniere für ihn die Mitarbeitenden-Ereignisse (created, updated, joined und left) mit dem v2-Payload.

4. Füge das Signing Secret, das Bob für den Webhook zeigt, in **Signing Secret** ein und wähle **Save**. Bis dahin lautet der Hinweis „This webhook accepts nothing until it has HiBob's signing secret.“

Mit gespeichertem Secret lautet der Hinweis „Pyn holds this webhook's signing secret, and accepts what HiBob signs with it.“, gefolgt von **Last received** und der Zeit der letzten Zustellung, oder **Nothing received yet**. Das Secret wird nie wieder angezeigt; zum Rotieren fügst du das neue in **Replace Signing Secret** ein und wählst **Save**. Pyn hält jede Zustellung, die es annimmt, einmal unter **History** als **Webhook Processed** fest (etwa „Received employee.updated for employee 123“) oder als **Invalid Webhook Payload**. Was das Directory erreicht, kommt weiterhin aus der Aktualisierung. Eine Zustellung, die eine Person nennt, die schon im Directory ist, löst außerdem jede veröffentlichte Automation aus, deren Trigger **HiBob Webhook** für diesen Ereignistyp ist; siehe den [Trigger-Katalog](https://support.pyn.ai/de/flows/automations/trigger-catalogue/#hibob-webhook). Pyn weist eine Zustellung ab, die die Prüfung nicht besteht oder bei deaktivierter Integration ankommt. Lass die erste Aktualisierung nach dem Verbinden abschließen, bevor du erwartest, dass sich **Last received** ändert.

## Fehlerbehebung

| Was du siehst | Was es bedeutet |
| --- | --- |
| History: „Error: Authentication failed, please reconnect“ | Das Token wurde rotiert oder die Anmeldung widerrufen. Verbinde neu. |
| History: „Error: Insufficient HiBob permissions“ | Der Service User hat den People-Lesezugriff oder eine Feldgruppe verloren. Erweitere seine Berechtigungen in Bob. |
| Personen oder Felder fehlen | Prüfe **Fields in Report** unter Advanced; ein Feld, das dort fehlt, ist für den Service User nicht sichtbar, oder dein Tenant hat es nicht. |
| Ausscheidende Personen bleiben aktiv | Gewähre Lifecycle-Zugriff auf ehemalige Mitarbeitende, damit Austrittsdaten synchronisiert werden. |
| History: **Invalid Webhook Payload** | Bob hat eine Zustellung gepostet, die Pyn nicht lesen konnte. Prüfe, ob der Webhook in Bob die Mitarbeitenden-Ereignisse mit dem v2-Payload abonniert hat. |
| Webhook **Last received** bleibt bei **Nothing received yet** | Das Signing Secret fehlt oder ist falsch, der Webhook in Bob postet an eine andere URL, oder seit dem Verbinden ist keine Aktualisierung gelaufen. Speichere das Secret, das Bob zeigt, prüfe die URL und prüfe **History** auf eine abgeschlossene Aktualisierung. |

## Verwandte Seiten

- [Integrations](https://support.pyn.ai/de/integrations/) für den Katalog.
- [HiBob-Feldzuordnung](https://support.pyn.ai/de/integrations/hibob/field-mapping/) für das Bob-Feld hinter jedem Pyn-Feld.
- [HRIS-Felder](https://support.pyn.ai/de/integrations/hris-fields/) für die Feldmatrix.
- [Synchronisierungsrhythmus und Abgleich](https://support.pyn.ai/de/integrations/sync-and-matching/) für Zeitpläne und Abgleich.
- [Employees](https://support.pyn.ai/de/directory/employees/), um die synchronisierten Datensätze zu prüfen.
