# Abonnenten verwalten

> Fügen Sie Personen zu einer Kontaktliste hinzu, bearbeiten Sie sie, aktivieren oder deaktivieren Sie ihr Kennzeichen Subscribed und entfernen Sie sie – in der Weboberfläche oder mit der API für Abonnenten.

Ein Abonnent ist die Mitgliedschaft eines Kontakts in einer Kontaktliste. Diese Seite zeigt, wie Sie Abonnenten hinzufügen, ändern, ab- oder erneut anmelden und entfernen, und was jede Änderung für den zugehörigen Kontakt bedeutet.

## Voraussetzungen

- Erstellen Sie zuerst die Kontaktliste. Siehe [Kontaktlisten](/de/docs/audiences/).
- Prüfen Sie, wie viel Platz die Kontaktliste noch hat. Das Limit zählt jeden Abonnenten, auch abgemeldete. Siehe [Limits](/de/docs/audiences/#limits).
- Verwenden Sie für die API einen API-Schlüssel mit **Full Access**.

## Abonnenten hinzufügen

**Weboberfläche**

  1. **Kontaktliste öffnen.** Öffnen Sie **Email Marketing → Audiences** und wählen Sie die Kontaktliste.

  2. **Person hinzufügen.** Wählen Sie **Add subscriber** und geben Sie **Email** sowie optional **First name** und **Last name** ein.

  3. **Speichern.** Wählen Sie **Add**. Gibt es für die Adresse noch keinen Kontakt, legt Emailit einen an.

  Sie können auch bestehende Kontakte unter **Email Marketing → Contacts** hinzufügen: Öffnen Sie einen Kontakt und wählen Sie **Add to audience**, oder wählen Sie mehrere Kontakte aus und nutzen Sie **Actions > Add to audience**. Um viele Personen auf einmal hinzuzufügen, [importieren Sie eine Datei](/de/docs/contacts/import-export/).

**API**

  Rufen Sie [Abonnent hinzufügen](/de/docs/api-reference/audiences/subscribers/add/) mit der ID oder dem Namen der Kontaktliste auf:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme" }
  }'
```

```json
{
  "object": "subscriber",
  "id": "sub_7Rt2vX9kLm3Qp",
  "audience_id": "aud_5hJ2kL8mNp4Qr",
  "contact_id": "con_2kq8Vt4xLm7Rz",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": { "company": "Acme" },
  "subscribed": true,
  "subscribed_at": "2026-10-01T09:30:00Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}
```

  Nur `email` ist erforderlich. Wenn Sie für einen bestehenden Kontakt `first_name`, `last_name` oder `custom_fields` übergeben, überschreiben diese die Werte des Kontakts, und `custom_fields` ersetzt das gesamte Objekt.

### Wenn die Person bereits auf der Kontaktliste steht

Was beim Hinzufügen einer Adresse passiert, die bereits auf der Kontaktliste steht, hängt von ihrem aktuellen Zustand ab:

| Aktueller Zustand | Ergebnis | API-Antwort |
| --- | --- | --- |
| Nicht auf der Kontaktliste | Ein neuer Abonnent wird mit aktiviertem **Subscribed** angelegt. | `201` |
| Auf der Kontaktliste, **Subscribed** aktiviert | Nichts ändert sich. Die Weboberfläche zeigt „Contact is already subscribed to this audience“. | `409` mit dem Abonnenten in `existing` |
| Auf der Kontaktliste, abgemeldet | Der Abonnent wird erneut angemeldet: **Subscribed** wird aktiviert, `subscribed_at` wird auf jetzt gesetzt und `unsubscribed_at` geleert. | `200` |
| Die Kontaktliste ist voll | Nichts wird hinzugefügt. | `422` mit `usage` |

Eine erneute Anmeldung über diesen Endpunkt sendet die Events `subscriber.updated` und `subscriber.resubscribed` und startet Automatisierungen mit dem Trigger **Added to audience**, genau wie ein neuer Abonnent.

> **Achtung:** Wenn Sie jemanden nach einer Abmeldung wieder hinzufügen, wird die Person erneut angemeldet. Tun Sie das nur, wenn die Person ausdrücklich wieder beitreten wollte, zum Beispiel durch eine Anmeldung auf Ihrer Website.

## Abonnenten bearbeiten

Öffnen Sie in der Abonnententabelle der Kontaktliste das Zeilenmenü und wählen Sie **Edit**. Sie können **First name**, **Last name** und den Schalter **Subscribed** ändern. Die E-Mail-Adresse ist hier schreibgeschützt.

Per API rufen Sie [Abonnent aktualisieren](/de/docs/api-reference/audiences/subscribers/update/) auf. Geben Sie den Abonnenten über seine `sub_`-ID oder seine E-Mail-Adresse an und senden Sie beliebige der Felder `email`, `first_name`, `last_name`, `custom_fields` und `subscribed`:

```bash
curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'
```

Namen, E-Mail-Adresse und eigene Felder gehören zum Kontakt, nicht zum Abonnenten. Wenn Sie sie hier ändern, wird der Kontakt überall aktualisiert, auch in seinen anderen Kontaktlisten. Nur `subscribed` gilt speziell für diese Kontaktliste.

## Subscribed aktivieren oder deaktivieren

Das Kennzeichen **Subscribed** entscheidet, ob Kampagnen an diese Kontaktliste die Person erreichen. Deaktivieren lässt den Abonnenten auf der Liste, speichert `unsubscribed_at` und lässt die anderen Kontaktlisten des Kontakts unverändert. Erneutes Aktivieren setzt ein neues `subscribed_at` und leert `unsubscribed_at`.

| Wo | Abmelden | Erneut anmelden |
| --- | --- | --- |
| Seite der Kontaktliste | **Edit**, dann **Subscribed** deaktivieren | **Edit**, dann **Subscribed** aktivieren |
| Kontaktseite | **Unsubscribe** im Zeilenmenü der Kontaktliste | **Resubscribe** im Zeilenmenü |
| API | [Abonnent aktualisieren](/de/docs/api-reference/audiences/subscribers/update/) mit `"subscribed": false` | Aktualisieren mit `"subscribed": true` oder die Adresse erneut [hinzufügen](/de/docs/api-reference/audiences/subscribers/add/) |

Diese Änderungen senden das Event `subscriber.updated`. Sie erfassen keine Abmeldung bei einer Kampagne und erscheinen daher nicht im Tab **Unsubscribes** einer Kampagne. Wenn sich Empfänger selbst über den Link in einer Kampagne abmelden, verlassen sie alle Kontaktlisten auf einmal. Siehe [Abmeldungen](/de/docs/audiences/unsubscribes/).

## Abonnenten entfernen

Wenn Sie einen Abonnenten entfernen, wird die Mitgliedschaft gelöscht. Wählen Sie im Zeilenmenü auf der Seite der Kontaktliste **Delete** oder auf der Kontaktseite **Remove from audience**, oder rufen Sie [Abonnent löschen](/de/docs/api-reference/audiences/subscribers/delete/) auf.

| | Abmelden | Entfernen |
| --- | --- | --- |
| Person bleibt auf der Liste | Ja, mit deaktiviertem **Subscribed** | Nein |
| Zählt zum Limit der Kontaktliste | Ja | Nein |
| Kontakt bleibt erhalten | Ja | Ja |
| Event | `subscriber.updated` | `subscriber.deleted`, das Automatisierungen mit dem Trigger **Removed from audience** startet |
| Erneutes Hinzufügen der Adresse | Meldet den bestehenden Abonnenten erneut an | Legt einen neuen Abonnenten an |

Melden Sie Personen, die keine E-Mails mehr möchten, lieber ab, damit die Abmeldung dokumentiert bleibt. Entfernen Sie Abonnenten, die Sie versehentlich hinzugefügt haben oder nicht mehr behalten möchten. Um die Person vollständig zu löschen, löschen Sie den Kontakt; damit wird er aus allen Kontaktlisten entfernt.

## Abonnenten auflisten und finden

Suchen Sie auf der Seite der Kontaktliste nach E-Mail-Adresse oder Namen und filtern Sie nach Email, First name, Last name, Subscribed oder Created.

Per API liefert [Abonnenten auflisten](/de/docs/api-reference/audiences/subscribers/list/) alle Abonnenten, auch abgemeldete. Fügen Sie `subscribed=true` oder `subscribed=false` hinzu, um die Liste einzugrenzen, `search`, um nach E-Mail-Adresse oder Namen zu suchen, und `page` sowie `limit` (bis zu 100) zum Blättern:

```bash
curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Um eine einzelne Person nachzuschlagen, nutzen Sie [Abonnent abrufen](/de/docs/api-reference/audiences/subscribers/get/) mit der `sub_`-ID oder der E-Mail-Adresse.

## Siehe auch

  - [Anmelde-URL](/de/docs/audiences/subscribe-url/): Personen sich selbst über Ihre Website eintragen lassen.
  - [Kontakte](/de/docs/contacts/): Die Person hinter jedem Abonnenten.

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