# Listen

Der Lists-Dienst ermöglicht Tenant-Administratoren, benannte Kontaktlisten zu erstellen, Kontakte per CSV-Upload oder Benutzerauswahl hinzuzufügen und sie zur Zielgruppenauswahl in den Campaigns- und Audiences-APIs zu verwenden.

## Anwendungsfälle

- CSV mit Leads oder Newsletter-Abonnenten importieren und in Kampagnen ansprechen.
- Bestehende Plattformbenutzer zur erneuten Ansprache gruppieren.
- Postal-E-Mail-Versände mit Listen abgleichen, um Öffnungen und Klicks je Liste zu messen.

## Mitgliederquellen

- **CSV-Import**: öffentlich erreichbare Datei mit einer `email`-Spalte hochladen. Adressen ohne Benutzerkonto werden als reine E-Mail-Einträge gespeichert.
- **Benutzerauswahl**: Mitglieder anhand von `user_id` hinzufügen; die E-Mail-Adresse wird automatisch aufgelöst.
- **Direkte E-Mail**: rohe E-Mail-Adressen hinzufügen. Wenn `first_name` und `last_name` angegeben sind und der Benutzer nicht existiert, wird er mit dem angegebenen Typ erstellt (Standard: `newsletter`).

## Mitgliedertypen

Das Feld `type` kennzeichnet die Herkunft: `newsletter` (Anmeldeformular), `contact` (importierter Lead ohne Konto), `customer` (bestehender Käufer) oder beliebige eigene Zeichenfolge.

## Analysen

`GET /v1/lists/:list_id/analytics` gleicht die E-Mail-Adressen der Mitglieder mit Postal-Versänden für einen `email_type` ab und gibt Öffnungs-, Klick- und Zustellraten der Liste zurück.