---
title: "BambooHR"
description: "Koppel BambooHR met je bedrijfsdomein, laat Pyn medewerkers lezen via een BambooHR-login, en houd de Directory actueel met een verversing per uur en wijzigingsmeldingen."
sidebar:
  label: Overzicht
  order: 0
area: integrations
feature: bamboohr
appPath: /settings/integrations/available
lastVerified: 2026-11-15
version: "2026-11-02"
audience: admin
related:
  - integrations
  - integrations/hris-fields
  - integrations/sync-and-matching
intercom:
  - id: "11614355"
    title: Connect to BambooHR (Pyn 2)
    url: https://intercom.help/pyn/en/articles/11614355-connect-to-bamboohr-pyn-2
    note: replaces
  - id: "10100088"
    title: "BambooHR Error \"Insufficient Permissions\""
    url: https://intercom.help/pyn/en/articles/10100088-bamboohr-error-insufficient-permissions
    note: replaces
  - id: "6024101"
    title: Why is employee data from BambooHR not appearing in Pyn?
    url: https://intercom.help/pyn/en/articles/6024101-why-is-employee-data-from-bamboohr-not-appearing-in-pyn
    note: replaces
  - id: "6330100"
    title: Connect to BambooHR (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6330100-connect-to-bamboohr-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/bamboohr/index.mdx
  sourceSha: c75c1409d92ecf48831371f6ed3d872a20c0df1c
---

De BambooHR-integratie leest je medewerkersdirectory en een aangepast rapport via de BambooHR-API, zodat startdatums, afdelingen, managers en vertrekkers je flows aansturen zonder spreadsheet. In workspaces waar de BambooHR-webhook is ingeschakeld, meldt BambooHR wijzigingen ook tussen verversingen door aan Pyn.

## Voordat je begint

- Je bent admin of owner in Pyn.
- Je kent je BambooHR-bedrijfsdomein: het deel vóór `.bamboohr.com` in je BambooHR-adres.
- Je kunt inloggen bij BambooHR met een account dat API-toegang heeft en de velden kan zien die je wilt synchroniseren. Een serviceaccount dat niet aan een medewerker hangt is beter dan de login van een persoon, die niet meer werkt wanneer die persoon vertrekt.

![Connect to BambooHR asks for your Company Domain.](https://support.pyn.ai/media/integrations/bamboohr/integrations-bamboohr-connect.png)

## Koppelen

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

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

3. Voer je **Company Domain** in. Je kunt het hele adres plakken, zoals `https://acme.bamboohr.com`; Pyn houdt `acme` over. "This is not a valid company domain." betekent dat het niet op een BambooHR-subdomein lijkt.

4. Selecteer **Connect**. BambooHR opent; log in en selecteer **Allow Access**.

5. BambooHR stuurt je terug naar Pyn. Het paneel toont "You're connected. Syncing can take a few minutes. Check the journey map then!" Weiger je bij BambooHR in plaats daarvan de toegang, of duurt het daar te lang, dan beland je op **Installed** met een toast met de titel **BambooHR wasn't connected** die zegt waarom: "You didn't grant access, so nothing was connected." of "The sign-in took too long, so nothing was connected. Try again."

## Wat er wordt gesynchroniseerd

Pyn ververst ongeveer één keer per uur; een run waarin het rapport niet is veranderd, wordt vastgelegd als "Successfully integrated to BambooHR. No employee changes found". In workspaces waar de webhook is ingeschakeld, worden de wijzigingsmeldingen van BambooHR zelf onder **History** vastgelegd zodra ze binnenkomen. Het tabblad **Details** toont het **Subdomain**, de **Primary Source** (Custom Report of Directory), **Last Refresh** en **Last Successful Refresh**; het tabblad **Advanced** toont onder **Fields in Report** een aantal per veld.

| Eigenschap in Pyn | Uit BambooHR |
| --- | --- |
| Weergavenaam, officiële naam, roepnaam | Weergavenaam, volledige naam en voorkeursnaam |
| Zakelijk e-mailadres, persoonlijk e-mailadres | Zakelijk e-mailadres en privé-e-mailadres |
| Startdatum | Datum in dienst; een oorspronkelijke datum in dienst die eerder ligt markeert een terugkerende medewerker |
| Datum uit dienst, status | Datum uit dienst; een andere arbeidsstatus dan Active wordt inactief |
| Afdeling, divisie, locatie, functietitel | De overeenkomstige BambooHR-velden |
| Type dienstverband | Status in de arbeidsgeschiedenis |
| Manager | Medewerkers-id van de supervisor |
| Verjaardag, land, postcode, tijdzone | Verjaardag en adres; tijdzone uit land en postcode |

Kan het account waarmee Pyn is gekoppeld alleen de directory lezen, dan waarschuwt het paneel: "This integration is pulling limited employee data from the BambooHR directory. To get a complete employee profile, have a BambooHR administrator reconnect this integration, or ask for expanded permissions." Zie [HRIS-velden](https://support.pyn.ai/nl/integrations/hris-fields/) voor de veldenmatrix.

## Testen

Open de tegel BambooHR onder **Installed**, open het menu **...** en selecteer **Test Connection**. "Successfully tested the connection to BambooHR." bevestigt het; "An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists." betekent dat de login niet meer werkt. Controleer daarna [Employees](https://support.pyn.ai/nl/directory/employees/).

## Opnieuw koppelen of ontkoppelen

- **Reconnect** herhaalt de BambooHR-login voor hetzelfde bedrijfsdomein. Gebruik het nadat het wachtwoord van het gekoppelde account is gewijzigd of zijn rechten zijn verruimd.
- **Deactivate** stopt het synchroniseren; **Activate** hervat het. **Archive** verwijdert de integratie uit Installed; gesynchroniseerde medewerkers blijven staan. Mislukt een van beide, dan meldt een toast **Could not deactivate the integration** of **Could not archive the integration** en verandert er niets.

## Problemen oplossen

| Wat je ziet | Wat het betekent |
| --- | --- |
| History: "Error: Insufficient permissions to access BambooHR" | Het toegangsniveau van het gekoppelde account is API- of veldrechten kwijt. Open in BambooHR **Access Levels > Custom Levels**, selecteer het niveau, en sta onder **Access Level Settings** **Settings > Company Field Settings** toe; koppel daarna opnieuw. |
| History: "Error: Authentication failed, please reconnect" | De login is verlopen of ingetrokken. Koppel opnieuw. |
| History: "Could not connect to BambooHR, please reconnect" | BambooHR heeft de verbinding geweigerd. Koppel opnieuw; herhaalt het zich, neem dan contact op met support. |
| History: "BambooHR returned data in an unexpected format" (oranje) | Een verversing kreeg een antwoord dat Pyn niet kon lezen, meestal eenmalig, dus de integratie blijft actief en de volgende verversing probeert het opnieuw. Herhaalt het zich bij elke run, neem dan contact op met support. |
| Medewerkers worden niet meer bijgewerkt nadat iemand is vertrokken | De integratie was gekoppeld met de login van die persoon. Koppel opnieuw met een account dat niet aan een medewerker hangt. |
| Velden zoals de startdatum zijn leeg | Ze zijn leeg in BambooHR, of het account kan ze niet zien. Controleer het aantal per veld onder Advanced. |

## Gerelateerd

- [Integrations](https://support.pyn.ai/nl/integrations/) voor de catalogus.
- [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.
