# Kontaktlisten

> Kontaktlisten sind die Listen, an die Ihre Kampagnen senden. Erstellen Sie Kontaktlisten, verwalten Sie Abonnenten, prüfen Sie das Abonnentenlimit Ihres Tarifs und nutzen Sie Kontaktlisten per API.

Eine Kontaktliste ist eine benannte Liste von Kontakten, etwa „Newsletter“ oder „Produkt-Updates“. Sie wählen eine oder mehrere Kontaktlisten als Empfänger einer [Kampagne](/de/docs/campaigns/) und können Personen von Hand, per Import, per API oder über eine gehostete Anmelde-URL zu einer Kontaktliste hinzufügen.

## So funktionieren Kontaktlisten

Jede Person auf einer Kontaktliste ist ein **Abonnent**: eine Verknüpfung zwischen einem [Kontakt](/de/docs/contacts/) und der Kontaktliste, mit einem eigenen Kennzeichen **Subscribed**. Derselbe Kontakt kann auf mehreren Kontaktlisten stehen und bei einigen angemeldet, bei anderen abgemeldet sein.

- **Kampagnen** senden an Abonnenten, deren Kennzeichen **Subscribed** gesetzt ist, deren Kontakt nicht global abgemeldet ist und deren Adresse nicht gesperrt ist. Ein Kontakt auf mehreren ausgewählten Kontaktlisten erhält nur ein Exemplar.
- **Abmelden** entfernt das Kennzeichen, lässt den Abonnenten aber auf der Liste, sodass der Verlauf erhalten bleibt. Siehe [Abmeldungen](/de/docs/audiences/unsubscribes/).
- **Einen Abonnenten löschen** entfernt die Person von der Liste. Der Kontakt bleibt in Ihrem Workspace.

## Die Seite Audiences

Öffnen Sie **Email Marketing → Audiences**, um Ihre Kontaktlisten mit **Name**, **Subscribers** und dem Datum **Created** zu sehen. Die Spalte **Subscribers** zeigt, wie viele Abonnenten jede Kontaktliste im Verhältnis zum Limit Ihres Tarifs hat, zum Beispiel `1.2k/10k`. Über das Zeilenmenü können Sie eine Kontaktliste mit **Manage subscribers** verwalten, mit **Rename** umbenennen oder mit **Delete** löschen.

Um eine Kontaktliste zu erstellen, wählen Sie **Create audience**, geben einen **Name** ein und wählen **Create**. Namen müssen im Workspace eindeutig sein.

## Die Seite einer Kontaktliste

Öffnen Sie eine Kontaktliste, um ihre Abonnenten zu verwalten. Die Kopfzeile zeigt die Zahl der Abonnenten und das Limit-Badge sowie diese Aktionen:

| Aktion | Was passiert |
| --- | --- |
| **Rename** | Ändert den Namen der Kontaktliste. |
| **Subscribe URL** | Zeigt die gehostete Anmelde-URL dieser Kontaktliste und lässt Sie sie zurücksetzen. Siehe [Anmelde-URL](/de/docs/audiences/subscribe-url/). |
| **Add subscriber** | Fügt eine Person anhand ihrer E-Mail-Adresse hinzu. Wird durch **Upgrade** ersetzt, wenn eine Kontaktliste bei Pay as you go voll ist. |
| **Delete** (im Menü) | Löscht die Kontaktliste und alle ihre Abonnenten. Die Kontakte bleiben in Ihrem Workspace. Das lässt sich nicht rückgängig machen. |

Darunter listet die Abonnententabelle **Email**, **First name**, **Last name**, **Subscribed** und **Created** auf, mit Suche, Filtern und einem Zeilenmenü, um jeden Abonnenten mit **Edit** zu bearbeiten oder mit **Delete** zu löschen. Siehe [Abonnenten verwalten](/de/docs/audiences/subscribers/).

## Limits

Jeder Tarif begrenzt, wie viele Abonnenten eine Kontaktliste haben kann. Die Zahl der Kontaktlisten ist nicht begrenzt.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Abonnenten pro Kontaktliste | 10.000 | 50.000 | 250.000 | Unbegrenzt |

Das Limit zählt jeden Abonnenten der Kontaktliste, auch Personen, die sich abgemeldet haben. Um Platz zu schaffen, löschen Sie Abonnenten, die Sie nicht mehr brauchen, [wechseln Sie in einen höheren Tarif](/de/docs/billing/plans/) oder beantragen Sie mit **Request Increase** auf der Karte **Sending Limits** der Startseite der Weboberfläche ein höheres Limit.

Ist eine Kontaktliste voll, ist **Add subscriber** deaktiviert, und jeder Weg, Personen hinzuzufügen, einschließlich API, Importen und Anmelde-URL, wird mit `422` und einer Meldung wie „Pro includes 50,000 subscribers per audience.“ abgelehnt. Der API-Fehler enthält die aktuelle `usage`:

```json
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}
```

## Per API nutzen

Mit der [API für Kontaktlisten](/de/docs/api-reference/audiences/) können Sie Kontaktlisten [erstellen](/de/docs/api-reference/audiences/create/), [abrufen](/de/docs/api-reference/audiences/get/), [umbenennen](/de/docs/api-reference/audiences/update/), [auflisten](/de/docs/api-reference/audiences/list/) und [löschen](/de/docs/api-reference/audiences/delete/); die [API für Abonnenten](/de/docs/api-reference/audiences/subscribers/) verwaltet die Personen darauf. In der URL können Sie statt der `aud_`-ID den Namen einer Kontaktliste verwenden. Die API erfordert einen API-Schlüssel mit **Full Access**.

```bash
curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'
```

Antworten zu Kontaktlisten enthalten `subscribers_count` und ein Objekt `usage` mit `used`, `limit` und `plan`. Beim Erstellen, Abrufen und Aktualisieren einer Kontaktliste wird außerdem ihr `token` zurückgegeben, der geheime Teil ihrer [Anmelde-URL](/de/docs/audiences/subscribe-url/). Ein doppelter Name gibt `409` zurück.

## Events

Änderungen an Kontaktlisten und Abonnenten erzeugen Events, die Sie per [Webhooks](/de/docs/webhooks/) empfangen können und die [Automatisierungen](/de/docs/automations/) starten:

| Event | Wann |
| --- | --- |
| [`audience.created`, `audience.updated`, `audience.deleted`](/de/docs/webhooks/events/audience/) | Eine Kontaktliste wird erstellt, umbenannt oder gelöscht. Beim Löschen einer Kontaktliste wird nicht für jeden ihrer Abonnenten ein Event gesendet. |
| [`subscriber.created`](/de/docs/webhooks/events/subscriber/) | Jemand wird in der Weboberfläche oder per API zu einer Kontaktliste hinzugefügt. Startet Automatisierungen mit dem Trigger **Added to audience**. |
| [`subscriber.updated`](/de/docs/webhooks/events/subscriber/) | Die Daten oder das Kennzeichen **Subscribed** eines Abonnenten ändern sich. |
| [`subscriber.deleted`](/de/docs/webhooks/events/subscriber/) | Ein Abonnent wird entfernt. Startet Automatisierungen mit dem Trigger **Removed from audience**. |

Importe und die Anmelde-URL senden keine Abonnenten-Events.

## Nächste Schritte

  - [Abonnenten verwalten](/de/docs/audiences/subscribers/): Personen hinzufügen, bearbeiten, abmelden und entfernen.
  - [Anmelde-URL](/de/docs/audiences/subscribe-url/): Anmeldungen über Ihre eigene Website sammeln.
  - [Abmeldungen](/de/docs/audiences/unsubscribes/): Wie Opt-outs über Kontaktlisten hinweg funktionieren.
  - [Kampagne senden](/de/docs/campaigns/create/): Den Abonnenten Ihrer Kontaktlisten E-Mails senden.

---
Quelle: https://emailit.com/de/docs/audiences/