---
title: "HiBob"
description: "Synchroniseer medewerkers uit Bob door in te loggen of met een service user, inclusief manager, HRBP, buddy, einddatum van de proeftijd en de aangepaste velden die je koppelt."
sidebar:
  label: Overzicht
  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
---

De HiBob-integratie leest mensen via de API van Bob en houdt de Directory actueel: namen, zakelijk en privé-e-mailadres, startdatum en datum uit dienst, einddatum van de proeftijd, afdeling, functietitel, site, manager, HRBP en, als je er een aangepast veld voor hebt, buddy. Pyn leest alleen; er wordt nooit naar Bob geschreven.

## Voordat je begint

- Je bent admin of owner in Pyn.
- Kies hoe je koppelt. **Connect with HiBob** logt je in bij Bob en autoriseert Pyn. **Use a service user instead** vraagt om een **Service User ID** en **API Token** van Bob die een Bob-beheerder aanmaakt onder **Settings > Integrations > Service Users**.
- Geef de service user, of je eigen account, leestoegang tot de Bob-categorieën met de velden die Pyn leest: About, Address (woonplaats, land en postcode), Basic Info, Employment, Home (privé-e-mailadres), Jobs, Lifecycle, Payroll > Employment (contract), Personal (korte geboortedatum) en Personal Contact Details, voor medewerkers inclusief pre-hires en vertrekkers.

![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)

## Koppelen

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

2. Selecteer de tegel **HiBob**. Het dialoogvenster **Connect to HiBob** opent: "You will be redirected to HiBob to authorize Pyn to access your company's employee data."

3. Om in te loggen selecteer je **Connect with HiBob**, autoriseer je Pyn in Bob en keer je terug.

4. Om in plaats daarvan een service user te gebruiken, selecteer je **Use a service user instead**, plak je de **Service User ID** en het **API Token**, en selecteer je **Connect**. Het dialoogvenster toont "Validating those credentials..."

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

Fouten die het dialoogvenster kan tonen: "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." De laatste is ook wat **Connect with HiBob** toont wanneer Pyn het inloggen niet kan starten.

## Wat er wordt gesynchroniseerd

Pyn ververst ongeveer één keer per uur vanuit Bob en legt elke run vast onder **History**. Het tabblad **Advanced** toont **Fields in Report**: de Bob-veld-id's die je tenant heeft teruggegeven en voor hoeveel mensen; kijk daar voordat je concludeert dat een veld niet beschikbaar is.

| Eigenschap in Pyn | Uit Bob |
| --- | --- |
| Weergavenaam, officiële naam | Weergavenaam, of voornaam en achternaam |
| Zakelijk e-mailadres, persoonlijk e-mailadres | E-mailadres en privé-e-mailadres |
| Startdatum, diensttijddatum | Startdatum; de diensttijd uit de oorspronkelijke startdatum, anders de startdatum |
| Datum uit dienst, einddatum proeftijd | Interne datum uit dienst en einddatum van de proeftijd |
| Afdeling, functietitel, locatie | Afdeling, functietitel en site van het werk (valt terug op de woonplaats uit het adres) |
| Manager | Reports-to, gematcht op Bob-id of medewerkers-id binnen het bedrijf |
| HRBP | Het veld `employee.hrbp` |
| Buddy | Het aangepaste veld dat op de integratie als buddyveld is ingesteld, samen met Pyn-support |
| Verjaardag, land, postcode, tijdzone | Korte geboortedatum en adres; tijdzone uit land en postcode |
| Contracttype, werkplek en andere aangepaste kolommen | Workspace-extensies gekoppeld aan een Bob-veld-id |

Zie [HiBob-veldmapping](https://support.pyn.ai/nl/integrations/hibob/field-mapping/) voor het Bob-veld-id achter elke eigenschap en wat je controleert wanneer er een ontbreekt, en [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de matrix.

## Testen

Open de tegel HiBob onder **Installed** en controleer **History** op een geslaagde verversing, open daarna [Employees](https://support.pyn.ai/nl/directory/employees/) en controleer startdatums, functietitels en managers.

## Opnieuw koppelen of ontkoppelen

- **Reconnect** opent **Reconnect to HiBob** met dezelfde twee keuzes. Heb je het token van een service user in Bob geroteerd, plak dan hier het nieuwe **API Token**. "Your HiBob integration has been updated." bevestigt het.
- **Deactivate** stopt het synchroniseren; **Activate** hervat het.

## Webhook

In workspaces waar de HiBob-webhook is ingeschakeld, heeft het geïnstalleerde HiBob-paneel een tabblad **Webhook**, zodat Bob wijzigingen in medewerkers aan Pyn kan melden zodra ze gebeuren. Je maakt de webhook in Bob aan met een adres dat Pyn je geeft en plakt het signing secret van Bob terug.

1. Open de tegel HiBob onder **Installed** en selecteer het tabblad **Webhook**. De callout leest "Have HiBob tell Pyn about employee changes as they happen, rather than waiting for the next sync." Selecteer **Set Up Webhook**.

2. Het tabblad toont nu het adres om naar te posten, met **Copy URL**. Maak in de webhookinstellingen van Bob een webhook aan die naar die URL post.

3. Abonneer hem op de medewerkersgebeurtenissen (created, updated, joined en left), met de v2-payload.

4. Plak het signing secret dat Bob voor de webhook toont in **Signing Secret** en selecteer **Save**. Tot je dat doet, leest de callout "This webhook accepts nothing until it has HiBob's signing secret."

Met het secret opgeslagen leest de callout "Pyn holds this webhook's signing secret, and accepts what HiBob signs with it." gevolgd door **Last received** en het tijdstip van de laatste levering, of **Nothing received yet**. Het secret wordt nooit meer getoond; om het te roteren plak je het nieuwe in **Replace Signing Secret** en selecteer je **Save**. Pyn legt elke levering die het accepteert één keer vast onder **History** als **Webhook Processed** (bijvoorbeeld "Received employee.updated for employee 123") of **Invalid Webhook Payload**. Wat de Directory bereikt komt nog steeds van de verversing. Een levering die een medewerker noemt die al in de Directory staat, laat ook elke gepubliceerde automation afgaan waarvan de trigger **HiBob Webhook** voor dat gebeurtenistype is; zie de [Triggercatalogus](https://support.pyn.ai/nl/flows/automations/trigger-catalogue/#hibob-webhook). Pyn wijst een levering af die de verificatie niet doorstaat of binnenkomt terwijl de integratie is gedeactiveerd. Laat de eerste verversing na het koppelen afronden voordat je verwacht dat **Last received** verandert.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| History: "Error: Authentication failed, please reconnect" | Het token is geroteerd of de login is ingetrokken. Koppel opnieuw. |
| History: "Error: Insufficient HiBob permissions" | De service user is people-read-toegang of een veldgroep kwijtgeraakt. Verruim zijn rechten in Bob. |
| Mensen of velden ontbreken | Controleer **Fields in Report** onder Advanced; een veld dat daar ontbreekt is niet zichtbaar voor de service user, of je tenant heeft het niet. |
| Vertrekkers blijven actief | Geef lifecycle-toegang tot voormalige medewerkers zodat datums uit dienst synchroniseren. |
| History: **Invalid Webhook Payload** | Bob heeft een levering gepost die Pyn niet kon lezen. Controleer of de webhook in Bob is geabonneerd op de medewerkersgebeurtenissen met de v2-payload. |
| **Last received** van de webhook blijft op **Nothing received yet** staan | Het signing secret ontbreekt of is onjuist, de webhook in Bob post naar een andere URL, of er heeft sinds het koppelen geen verversing gedraaid. Sla het secret op dat Bob toont, controleer de URL en controleer **History** op een afgeronde verversing. |

## Gerelateerd

- [Integrations](https://support.pyn.ai/nl/integrations/) voor de catalogus.
- [HiBob-veldmapping](https://support.pyn.ai/nl/integrations/hibob/field-mapping/) voor het Bob-veld achter elk veld in Pyn.
- [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de veldenmatrix.
- [Synchronisatiefrequentie en matching](https://support.pyn.ai/nl/integrations/sync-and-matching/) voor schema's en matching.
- [Employees](https://support.pyn.ai/nl/directory/employees/) om de gesynchroniseerde records te controleren.
