> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Personio verbinden

> Verbinde Personio mit Automations über deine eigenen Personio-API-Zugangsdaten, ohne Anmeldefenster

Verbinde Personio, um deine HR-Daten in Automatisierungen zu lesen: Personen, Beschäftigungen, Abwesenheiten, Anwesenheiten, Projekte und Dokumente. Personio hat kein Anmeldefenster für andere Apps. Stattdessen legst du in deinem Personio-Konto API-Zugangsdaten an und fügst Client-ID und Secret in Famulor ein.

Das bekommst du: die Personio-**Aktionen** im [App Catalog](/de/automations/app-catalog). Alle lesen Daten; Auslöser bietet Personio hier nicht.

| Aktion | Was sie liefert |
| - | - |
| List persons | Aktuelle Personen, gefiltert nach Identität, Status oder Anlagedatum |
| List person employments | Beschäftigungen einer Person, mit Status, Art und Arbeitszeit |
| List absence periods | Abwesenheiten, gefiltert nach Person, Abwesenheitsart oder Zeitraum |
| List absence types | Die in deinem Unternehmen eingerichteten Abwesenheitsarten |
| List attendance periods | Anwesenheiten, gefiltert nach Personen, Projekten, Status oder Datum |
| List projects | Projekte der Zeiterfassung |
| List documents | Dokument-Metadaten einer Person, optional nach Kategorie und Datum |
| List document categories | Die Dokumentkategorien und ihre IDs |
| List employee attributes | Die Standard- und eigenen Mitarbeiterattribute, die die Zugangsdaten lesen dürfen |
| List employee records | Mitarbeiterdatensätze mit den Attributen deiner Wahl |

## Bevor du startest

* Du bist Personio-Nutzer mit **API-Zugriffsrechten**. Ohne sie lässt dich Personio keine API-Zugangsdaten anlegen.
* Dein Famulor-Workspace hat die Automatisierungsplattform im Tarif, und du bist Owner oder Admin des Workspaces.

Client-ID und Secret bleiben beim App-Connector; Famulor speichert sie nie in deinem Workspace.

## Schritt 1 – API-Zugangsdaten in Personio anlegen

1. Öffne in Personio **Marketplace → Connected integrations** und gehe zu **API credentials**.
2. Lege neue Zugangsdaten an und gib ihnen einen Namen, den du wiedererkennst, zum Beispiel *Famulor*.
3. Aktiviere den **Lesezugriff** für die Daten, die deine Automatisierungen brauchen. **Personen** ist Pflicht, weil Famulor damit die Verbindung prüft. Nimm Abwesenheiten, Anwesenheiten, Projekte, Dokumente und Mitarbeiterattribute dazu, wenn du diese Aktionen nutzen willst.
4. Speichere und kopiere **Client-ID** und **Client-Secret**. Personio zeigt das Secret nur einmal an. Geht es verloren, setze die Zugangsdaten zurück und nutze das neue Paar.

## Schritt 2 – In Famulor verbinden

1. Gehe zu **Automations → Connections** und klicke auf **New connection**.
2. Öffne den **App marketplace**, suche nach **Personio** und wähle es aus.
3. Trage **Client-ID** und **Client-Secret** ein. Der Verbindungsname ist optional; leer heißt die Verbindung *Personio*.
4. Klicke auf **Personio verbinden**.

Famulor prüft die Zugangsdaten sofort bei Personio. Klappt das, erscheint die Verbindung mit **ok** in der Verbindungsliste, und die Personio-Aktionen stehen in jeder Automatisierung des Workspaces bereit.

## Fehlerbehebung

| Meldung | Bedeutung | Lösung |
| - | - | - |
| *Personio hat die Client-ID oder das Secret abgelehnt* | Ein Tippfehler, oder das Secret wurde in Personio zurückgesetzt. | Kopiere beide Werte erneut, oder setze die Zugangsdaten zurück und nutze das neue Paar. |
| *Personio hat die Zugangsdaten akzeptiert, sie dürfen aber keine Mitarbeiter lesen* | Die Zugangsdaten haben keinen Lesezugriff auf Personen. | Bearbeite die Zugangsdaten in Personio, aktiviere den Lesezugriff auf Personen und verbinde erneut. |
| Ein Automatisierungsschritt scheitert mit einem Berechtigungsfehler | Den Zugangsdaten fehlt der Lesezugriff auf diese Daten. | Ergänze den Lesezugriff in Personio und wähle dann in Famulor bei der Verbindung **Zugangsdaten ersetzen**. |

## Neu verbinden und entfernen

* **Zugangsdaten ersetzen:** Öffne die Verbindung unter Automations → Connections und wähle **Bearbeiten**. Trage die neue Client-ID und das neue Secret ein; Famulor ersetzt die gespeicherten Zugangsdaten in einem Schritt.
* **Entfernen:** Wenn du die Verbindung löschst, werden die Zugangsdaten auch beim App-Connector entfernt. Automatisierungen, die sie genutzt haben, zeigen *Connect needed*, bis du Personio erneut verbindest.
* Um den Zugriff auf Personio-Seite zu entziehen, lösche die API-Zugangsdaten in Personio oder setze sie zurück.

## Verwandt

* [App Catalog](/de/automations/app-catalog)
* [Referenz der Automations-Nodes](/de/automations/nodes)
* [Automations-Überblick](/de/automations/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.