# Bestehende Daten übernehmen (/how-to/onboarding/import-existing-data)



## Überblick [#überblick]

Dieser Leitfaden zeigt, wie du bestehende Daten in iglesio übernimmst. Zwei Wege stehen zur Auswahl: **CSV-Import** (empfohlen, stabil) und **direkte API-Anbindung** (in Entwicklung).

## Bevor du startest [#bevor-du-startest]

* Du brauchst Admin-Rechte.
* Für CSV: eine UTF-8-codierte Datei mit Überschriften-Zeile.
* Für API: Zugangsdaten für dein Quellsystem.

## Option A: CSV-Import [#option-a-csv-import]

1. Öffne **Einstellungen → Import**.
2. Lade die CSV hoch.
3. Ordne Spalten im Zuordnung-Schritt den iglesio-Feldern zu.
4. Starte den Import.
5. Nach Abschluss siehst du: `{n} Personen hinzugefügt, {m} als Duplikate übersprungen, {e} Fehler`.

Details siehe [Personen importieren](/how-to/people/import-people).

## Option B: API-Verbindung [#option-b-api-verbindung]

1. Öffne **Einstellungen → Synchronisierung**.
2. Wähle ein System: **Planning Center**, **ChurchTools**, **Elvanto**, **ChurchSuite**, **Subsplash**.
3. Gib die geforderten Zugangsdaten ein:
   * OAuth 2.0: du wirst beim Anbieter authentifiziert.
   * API-Schlüssel: trage **App-ID**, **Secret**, **Token**, **Instanz-URL** oder **Subdomain** ein, je nach System.
4. Klicke **Verbindung testen**.
5. Bei Erfolg startest du **Daten entdecken** – iglesio zeigt, wie viele Personen und Gruppen gefunden wurden.
6. Klicke **Jetzt importieren**, um die Synchronisation zu starten.

Laufende und vergangene Synchronisationen siehst du im **Synchronisationsverlauf**.

<Callout type="warn">
  Die direkten API-Migrationen sind teilweise ausgeliefert (Coverage 13.8,
  partial). Spezifische Zuordnungen pro System und alle OAuth-Flows sind nicht
  in allen Systemen vollständig bestätigt. Bei Problemen den CSV-Weg als
  verlässlichen Fallback nutzen.
</Callout>

## Siehe auch [#siehe-auch]

* [Personen importieren](/how-to/people/import-people)
* [Duplikate bereinigen](/how-to/people/handle-duplicates)
* [Einrichtungs-Assistent abschliessen](/how-to/onboarding/complete-setup-wizard)
