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

# Wie importiere ich Mitarbeitende über die REST API?

> Verbinde die REST-API-Integration, um deine aktiven Mitarbeitenden aus deinem eigenen HR-System nach Honestly zu importieren und synchron zu halten.

[Zu den Integrationen ↗](https://webapp.honestly.de/app#/integrations) · Öffnet die Webapp — bitte vorher anmelden

Über die REST API sendest du deine aktiven Mitarbeitenden an Honestly. Sie laufen durch dieselbe Import-Engine wie jede andere Mitarbeiterquelle — die REST API ist also die programmierbare Alternative zum CSV-Import über SFTP. Statt eine Datei hochzuladen, überträgt dein HR-System die Mitarbeitenden direkt, sobald sich etwas ändert.

Dieser Artikel richtet sich an HR-Admins und deren IT, die den Import einrichten. Die vollständige technische Beschreibung der Schnittstelle findest du in der [API-Dokumentation](/developers/api-reference/employee-import).

Nur Admins können die Integrationsseite sehen und verwalten.

### Integration verbinden

1. Gehe zu **Einstellungen → Integrationen** und öffne die Kachel **REST API**.
2. Klicke auf **Verbinden**. Honestly erzeugt einen **API-Schlüssel**.
3. Kopiere ihn mit **Schlüssel kopieren** und hinterlege ihn in dem System, das deine HR-Daten überträgt. Bestätige anschließend mit **Ich habe den Schlüssel kopiert**.

<Note>
  Der **API-Schlüssel** wird nur ein einziges Mal angezeigt. Geht er verloren, öffne die Kachel über **Bearbeiten** und erzeuge mit **Schlüssel erneuern** einen neuen. Der alte Schlüssel wird dabei sofort ungültig.
</Note>

Im selben Dialog stehen der **Endpunkt** und der Hinweis, dass die Authentifizierung über den Header **X-Api-Key** läuft. Der Schlüssel aus dieser Integration darf ausschließlich Mitarbeitende schreiben und kann keine Daten über die Export-API lesen. Umgekehrt funktionieren die auf der Seite für API-Schlüssel erzeugten Lese-Schlüssel hier nicht.

### Wie der Import funktioniert

Jede Anfrage überträgt die **vollständige Liste deiner aktiven Mitarbeitenden** — eine Momentaufnahme, kein Zusatz zum Bestand. Daraus folgt:

* Mitarbeitende, die du sendest, werden angelegt oder aktualisiert.
* Mitarbeitende, die du nicht mehr sendest, werden geoffboardet, also aus dem aktiven Bestand entfernt — allerdings nur solche, die über die REST API angelegt wurden.

Manuell, per Excel, per SFTP-CSV oder über einen HCM-Konnektor angelegte Mitarbeitende bleiben von diesem Import unberührt. In der Spalte **Quelle** der Mitarbeiterliste erkennst du die Herkunft jedes Eintrags; mehr dazu in [Importquelle prüfen](/de/help/employees/check-import-source).

### Die Löschschwelle

Damit eine fehlerhafte Übertragung nicht versehentlich einen Großteil deiner Belegschaft entfernt, gibt es im Verbinden-Dialog die **Löschschwelle**.

Ein Import, der mehr als diesen Anteil der über die REST API importierten Mitarbeitenden löschen würde, wird vollständig abgebrochen und ändert nichts. Voreingestellt sind 20 %; du kannst den Wert im Dialog anpassen.

<Warning>
  Erhöhe die **Löschschwelle** nur für einen geplanten Massenaustritt und setze sie danach wieder zurück. Bei einem sehr hohen Wert schützt dich fast nichts mehr: Eine fehlerhafte Anfrage kann dann deine gesamte Belegschaft offboarden.
</Warning>

### REST API oder CSV/SFTP?

Beide Wege führen durch dieselbe Import-Engine und folgen demselben Momentaufnahme-Prinzip. Der Unterschied liegt in der Übertragung:

* **REST API** — dein HR-System sendet die Mitarbeitenden direkt, sobald sich etwas ändert.
* **CSV über SFTP** — du legst eine Datei ab, die zu festen Zeiten eingelesen wird. Siehe [HR-System-Sync](/de/help/employees/sync-hr-data).

Es kann immer nur eine Mitarbeiterquelle gleichzeitig aktiv sein. Solange eine andere Anbindung — CSV/SFTP oder ein HCM-Konnektor — verbunden ist, lässt sich die Kachel **REST API** nicht verbinden. Trenne zuerst die bestehende Anbindung.

Für **SAP SuccessFactors** gibt es keinen Direktkonnektor. Die Anbindung läuft daher entweder über CSV/SFTP oder über die REST API.