# Sperrungen verwalten

> Sperrungen in der Weboberfläche oder per API ansehen, filtern, hinzufügen, importieren, exportieren und löschen, die automatische Sperrung konfigurieren und gesperrte E-Mails erneut senden.

Diese Anleitung behandelt alle Aufgaben rund um die Sperrliste: Einträge finden, einzeln oder aus einer CSV-Datei hinzufügen, exportieren, entfernen und die automatische Sperrung steuern. Wie Sperrungen funktionieren, erfahren Sie unter [Sperrungen](/de/docs/suppressions/).

## Voraussetzungen

- Jedes Mitglied des Workspaces kann die Liste in der Weboberfläche verwalten. Um die Einstellungen der automatischen Sperrung zu ändern, müssen Sie Admin sein.
- Verwenden Sie für die API einen API-Schlüssel mit **Full Access**.

## Liste ansehen und filtern

**Weboberfläche**

  Öffnen Sie **Email API → Suppressions**. Die Tabelle listet für jede Sperrung **Email**, **Reason** und **Created at** auf, die neuesten zuerst.

  - **Search** durchsucht die E-Mail-Adresse und den Grund.
  - **Filters** fügen Regeln für **Email**, **Reason**, **Type** oder **Created at** hinzu, etwa *Type equals complaint*. Drücken Sie Enter oder wählen Sie **Apply**.
  - **Display options > Edit columns** blendet die Spalte **Type** ein.
  - Wählen Sie eine Spaltenüberschrift, um danach zu sortieren.

**API**

  Rufen Sie [Sperrungen auflisten](/de/docs/api-reference/suppressions/list/) auf. Sie können nach `email`, `reason`, `type`, `created_at` und `keep_until` filtern:

```bash
curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"
```

  Um eine einzelne Adresse nachzuschlagen, rufen Sie [Sperrung abrufen](/de/docs/api-reference/suppressions/get/) mit ihrer `sup_`-ID oder der E-Mail-Adresse auf. Alle Operatoren finden Sie unter [Filtern und Sortieren](/de/docs/api-reference/filtering/).

## Sperrung hinzufügen

**Weboberfläche**

  1. **Liste öffnen.** Öffnen Sie **Email API → Suppressions** und wählen Sie **Add suppression**.

  2. **Angaben eingeben.** Geben Sie die Adresse unter **Email** und optional einen **Reason** ein, an dem Sie den Eintrag später wiedererkennen.

  3. **Create wählen.** Die Adresse wird mit dem Typ `recipient` hinzugefügt, der alle E-Mails an sie blockiert.

  Für einen anderen Typ oder eine Sperrung, die abläuft, verwenden Sie die API oder einen CSV-Import.

**API**

  Rufen Sie [Sperrung erstellen](/de/docs/api-reference/suppressions/create/) auf:

```bash
curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'
```

  | Feld | Erforderlich | Beschreibung |
  | --- | --- | --- |
  | `email` | Ja | Die zu sperrende Adresse. |
  | `type` | Nein | `recipient` (Standardwert), `bounce`, `complaint` oder `unsubscribe`. |
  | `reason` | Nein | Freitext. |
  | `keep_until` | Nein | Wann die Sperrung abläuft: ISO 8601, ein Unix-Zeitstempel oder einfaches Englisch wie `in 30 days`. Lassen Sie das Feld weg, um dauerhaft zu sperren. |

  Dieselbe Adresse kann mit demselben Typ nur einmal hinzugefügt werden. Ein Duplikat gibt `409 Suppression already exists for this email and type` zurück.

## CSV-Datei importieren

Nutzen Sie einen Import, um eine Sperrliste von einem anderen Anbieter zu übernehmen oder viele Adressen auf einmal hinzuzufügen.

1. **Datei vorbereiten.** Verwenden Sie eine `.csv`-Datei mit den Spalten `email`, `type` und `reason`:

```csv title="suppressions.csv"
email,type,reason
ada@example.com,bounce,Hard bounce at previous provider
grace@example.com,unsubscribe,Unsubscribed in 2025
alan@example.com,,Requested removal
```

   - `email` ist erforderlich. `type` und `reason` sind optional.
   - Ein leerer oder unbekannter `type` wird zu `recipient`.
   - Die Kopfzeile ist optional. Ohne sie liest Emailit die Spalten in der Reihenfolge `email`, `type`, `reason`.
   - Die Datei muss kleiner als 8 MB sein und darf höchstens 10.000 Zeilen haben.

2. **Datei hochladen.** Wählen Sie unter **Email API → Suppressions** **Import** und wählen Sie dann die Datei aus oder ziehen Sie sie auf **Select a file or drag it here**.

3. **Ergebnis prüfen.** Emailit fügt neue Einträge hinzu und überspringt Adressen, die bereits eine Sperrung desselben Typs haben. Zeilen mit ungültigen E-Mail-Adressen werden übersprungen.

Bei mehr als 10.000 Adressen teilen Sie die Datei auf. Um aus Code zu importieren, rufen Sie [Sperrung erstellen](/de/docs/api-reference/suppressions/create/) für jede Adresse auf.

## Liste exportieren

1. **Auswahl eingrenzen.** Durchsuchen oder filtern Sie die Liste unter **Email API → Suppressions** nach Bedarf. Der Export enthält nur, was angezeigt wird.

2. **Exportieren.** Wählen Sie **Export** und dann im Popover erneut **Export**. Emailit lädt `suppressions.csv` herunter.

Die Datei hat die Spalten `email`, `type`, `reason` und `created_at` und enthält bis zu 10.000 Zeilen.

## Sperrungen löschen

Wenn Sie eine Sperrung löschen, kann Emailit wieder an die Adresse senden. Stellen Sie sicher, dass die Adresse gültig ist und die Person Ihre E-Mails möchte, sonst kann der nächste Versand bouncen oder eine Beschwerde auslösen.

**Weboberfläche**

  - **Eine:** Wählen Sie das Papierkorbsymbol in ihrer Zeile und bestätigen Sie.
  - **Mehrere:** Markieren Sie die Zeilen mit den Checkboxen, wählen Sie **Delete suppressions** und bestätigen Sie.

**API**

  Rufen Sie [Sperrung löschen](/de/docs/api-reference/suppressions/delete/) mit der `sup_`-ID oder der E-Mail-Adresse auf:

```bash
curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Hat eine Adresse Sperrungen mehrerer Typen, verwenden Sie die `sup_`-ID, damit Sie die richtige löschen.

  Um eine Sperrung stattdessen zu ändern, etwa um ein Ablaufdatum hinzuzufügen, rufen Sie [Sperrung aktualisieren](/de/docs/api-reference/suppressions/update/) mit `type`, `reason` oder `keep_until` auf. Setzen Sie `keep_until` auf `null`, um das Ablaufdatum zu entfernen.

## Automatische Sperrung konfigurieren

Emailit setzt Adressen, die bouncen oder Beschwerden auslösen, automatisch auf die Liste. Bei Pro und Business können Admins das ändern.

1. **Einstellungen öffnen.** Öffnen Sie **Workspace → Settings** und wählen Sie den Tab **Suppressions**.

2. **Aktivieren oder deaktivieren.** Verwenden Sie **Enable automatic suppression**.

3. **Auswählen, was gesperrt wird.** Wählen Sie unter **Suppress on** **Bounces and Complaints** (Standardwert), **Bounces only** oder **Complaints only**.

In den Tarifen Pay as you go und Custom ist die automatische Sperrung für Bounces und Beschwerden immer aktiv. Die Bedienelemente zeigen das Badge **Pro** und lassen sich nicht ändern. Mitglieder, die keine Admins sind, können die Einstellungen ansehen, aber nicht ändern. Wann genau Emailit eine Adresse sperrt, erfahren Sie unter [Bounces und Beschwerden](/de/docs/deliverability/bounces-and-complaints/#automatic-suppression).

## Gesperrte E-Mails erneut senden

Eine Nachricht, die durch eine Sperrung blockiert wurde, bleibt `suppressed`, auch nachdem Sie die Sperrung gelöscht haben. So senden Sie sie:

1. **Sperrung löschen** für die Adresse, wie oben beschrieben. Sonst wird auch das erneute Senden gesperrt.

2. **E-Mail erneut senden.** Öffnen Sie sie unter **Email API → Emails** und wählen Sie **Retry** oder rufen Sie [E-Mail erneut senden](/de/docs/api-reference/emails/retry/) auf.

Erneutes Senden erstellt eine neue E-Mail mit demselben Inhalt und einer neuen ID und kostet Credits wie jeder andere Versand. Sie können E-Mails erneut senden, die bis zu 30 Tage alt sind, solange ihr Inhalt noch innerhalb Ihres Zeitraums für die [Datenaufbewahrung](/de/docs/data-retention/) liegt.

## Siehe auch

  - [Sperrungen](/de/docs/suppressions/): Typen, automatische Sperrung und Ablauf.
  - [Bounces und Beschwerden](/de/docs/deliverability/bounces-and-complaints/): Wann Emailit eine Adresse sperrt.
  - [Sperrungen-API](/de/docs/api-reference/suppressions/): Alle Endpunkte für Sperrungen.
  - [E-Mail-Verifizierung](/de/docs/email-verification/): Ungültige Adressen vor dem Versand entfernen.

---
Quelle: https://emailit.com/de/docs/suppressions/manage/