---
title: "BambooHR"
description: "Verbinde BambooHR über deine Firmendomain, lass Pyn Mitarbeitende über eine BambooHR-Anmeldung lesen und halte das Directory mit stündlicher Aktualisierung und Änderungsbenachrichtigungen aktuell."
sidebar:
  label: Übersicht
  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
---

Die BambooHR-Integration liest dein Mitarbeitendenverzeichnis und einen eigenen Report über die BambooHR-API, sodass Startdaten, Abteilungen, Führungskräfte und ausscheidende Personen deine Flows ohne Tabelle steuern. In Workspaces, in denen der BambooHR-Webhook aktiviert ist, benachrichtigt BambooHR Pyn außerdem über Änderungen zwischen den Aktualisierungen.

## Bevor du beginnst

- Du bist Admin oder Owner in Pyn.
- Du kennst deine BambooHR-Firmendomain: den Teil vor `.bamboohr.com` in deiner BambooHR-Adresse.
- Du kannst dich bei BambooHR mit einem Konto anmelden, das API-Zugriff hat und die Felder sehen kann, die du synchronisieren willst. Ein Servicekonto ohne Person dahinter ist besser als der Login einer Person, der nicht mehr funktioniert, sobald diese Person geht.

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

## Verbinden

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

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

3. Gib deine **Company Domain** ein. Du kannst die ganze Adresse einfügen, etwa `https://acme.bamboohr.com`; Pyn behält `acme`. „This is not a valid company domain.“ heißt, sie sieht nicht wie eine BambooHR-Subdomain aus.

4. Wähle **Connect**. BambooHR öffnet sich; melde dich an und wähle **Allow Access**.

5. BambooHR bringt dich zurück zu Pyn. Das Panel zeigt „You're connected. Syncing can take a few minutes. Check the journey map then!“ Lehnst du den Zugriff bei BambooHR stattdessen ab oder dauert es dort zu lange, landest du auf **Installed** mit einem Toast mit dem Titel **BambooHR wasn't connected**, der den Grund nennt: „You didn't grant access, so nothing was connected.“ oder „The sign-in took too long, so nothing was connected. Try again.“

## Was synchronisiert wird

Pyn aktualisiert etwa einmal pro Stunde; ein Lauf, in dem sich der Report nicht geändert hat, wird als „Successfully integrated to BambooHR. No employee changes found“ protokolliert. In Workspaces mit aktiviertem Webhook werden BambooHRs eigene Änderungsbenachrichtigungen unter **History** protokolliert, sobald sie eintreffen. Der Tab **Details** zeigt **Subdomain**, **Primary Source** (Custom Report oder Directory), **Last Refresh** und **Last Successful Refresh**; der Tab **Advanced** listet **Fields in Report** mit einer Anzahl pro Feld.

| Pyn-Eigenschaft | Aus BambooHR |
| --- | --- |
| Anzeigename, rechtlicher Name, Rufname | Anzeigename, vollständiger Name und Rufname |
| Geschäftliche E-Mail, private E-Mail | Geschäftliche E-Mail und private E-Mail |
| Startdatum | Einstellungsdatum; ein früheres ursprüngliches Einstellungsdatum markiert eine zurückkehrende Person |
| Austrittsdatum, Status | Austrittsdatum; ein Beschäftigungsstatus außer Active wird inaktiv |
| Abteilung, Division, Standort, Jobtitel | Die passenden BambooHR-Felder |
| Beschäftigungsart | Status der Beschäftigungshistorie |
| Führungskraft | Mitarbeitenden-ID der vorgesetzten Person |
| Geburtstag, Land, Postleitzahl, Zeitzone | Geburtstag und Adresse; Zeitzone aus Land und Postleitzahl |

Kann das Konto, mit dem Pyn verbunden wurde, nur das Verzeichnis lesen, warnt das Panel: „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.“ Siehe [HRIS-Felder](https://support.pyn.ai/de/integrations/hris-fields/) für die Feldmatrix.

## Testen

Öffne die Kachel BambooHR unter **Installed**, öffne das Menü **...** und wähle **Test Connection**. „Successfully tested the connection to BambooHR.“ bestätigt es; „An error occurred connecting to BambooHR. Please Reconnect or contact support if the issue persists.“ heißt, die Anmeldung funktioniert nicht mehr. Prüfe dann [Employees](https://support.pyn.ai/de/directory/employees/).

## Neu verbinden oder trennen

- **Reconnect** wiederholt die BambooHR-Anmeldung für dieselbe Firmendomain. Nutze es, nachdem sich das Passwort des verbundenen Kontos geändert hat oder seine Berechtigungen erweitert wurden.
- **Deactivate** stoppt die Synchronisierung; **Activate** setzt sie fort. **Archive** entfernt die Integration aus Installed; synchronisierte Mitarbeitende bleiben. Schlägt eines davon fehl, zeigt ein Toast **Could not deactivate the integration** oder **Could not archive the integration**, und nichts ändert sich.

## Fehlerbehebung

| Was du siehst | Was es bedeutet |
| --- | --- |
| History: „Error: Insufficient permissions to access BambooHR“ | Die Zugriffsstufe des verbundenen Kontos hat API- oder Feldberechtigungen verloren. Öffne in BambooHR **Access Levels > Custom Levels**, wähle die Stufe und erlaube unter **Access Level Settings** **Settings > Company Field Settings**, dann verbinde neu. |
| History: „Error: Authentication failed, please reconnect“ | Die Anmeldung ist abgelaufen oder wurde widerrufen. Verbinde neu. |
| History: „Could not connect to BambooHR, please reconnect“ | BambooHR hat die Verbindung verweigert. Verbinde neu; wiederholt es sich, kontaktiere den Support. |
| History: „BambooHR returned data in an unexpected format“ (gelb) | Eine Aktualisierung bekam eine Antwort, die Pyn nicht lesen konnte, meist ein Einzelfall, die Integration bleibt also aktiv und die nächste Aktualisierung versucht es erneut. Wiederholt es sich bei jedem Lauf, kontaktiere den Support. |
| Mitarbeitende werden nicht mehr aktualisiert, nachdem jemand gegangen ist | Die Integration wurde mit dem Login dieser Person verbunden. Verbinde mit einem Konto ohne Person dahinter neu. |
| Felder wie das Startdatum sind leer | Sie sind in BambooHR leer, oder das Konto kann sie nicht sehen. Prüfe die Feldanzahl unter Advanced. |

## Verwandte Seiten

- [Integrations](https://support.pyn.ai/de/integrations/) für den Katalog.
- [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.
