Unterdrückungen

Die Unterdrückungsliste verhindert, dass E-Mails an Adressen gesendet werden, die gebounced haben, sich abgemeldet haben oder Beschwerden eingereicht haben. MailLand verwaltet Unterdrückungen automatisch basierend auf Bounce- und Beschwerde-Events, und Sie können Einträge manuell über die API hinzufügen oder entfernen.

UnterdrückungstypenLink zum Abschnitt kopieren

Unterdrückungs-GeltungsbereicheLink zum Abschnitt kopieren

Geltungsbereiche steuern, welche Arten von E-Mails blockiert werden:

Geltungsbereichs-Einschränkungen:

• HardBounce, Complaint, Invalid, SpamTrap, RoleAddress → nur globaler Geltungsbereich
• SoftBounce → typischerweise Marketing-Geltungsbereich
• Unsubscribe → Global, Marketing oder List (nicht Transactional)
• Manual → beliebiger Geltungsbereich

Unterdrückungen auflistenLink zum Abschnitt kopieren

GET https://api.mail.land/v1/transactional/suppressions

Authentifizierung mit Authorization: Bearer <token> oder X-API-Key: <api key>.

curl https://api.mail.land/v1/transactional/suppressions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

AbfrageparameterLink zum Abschnitt kopieren

{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "email": "[email protected]",
      "suppressionType": "hardBounce",
      "scope": "global",
      "mailingListId": null,
      "mailingListName": null,
      "expiresAt": null,
      "reason": "550 5.1.1 The email account does not exist",
      "bounceType": "Hard",
      "bounceCategory": "invalid_recipient",
      "bounceCount": 1,
      "lastBounceAt": "2026-02-17T12:00:00Z",
      "unsubscribeSource": null,
      "campaignId": null,
      "subscriberId": null,
      "source": "webhook",
      "notes": null,
      "createdAt": "2026-02-17T12:00:01Z",
      "isLocked": false,
      "lockedReason": null
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

mailingListId, campaignId und subscriberId sind die öffentliche ID der jeweils verknüpften Ressource, aufgelöst innerhalb Ihres Mandanten, niemals die interne numerische Zeilen-ID. Jedes Feld ist null, wenn kein solcher Bezug besteht oder die verknüpfte Ressource inzwischen gelöscht wurde.

Unterdrückungs-StatistikenLink zum Abschnitt kopieren

Erhalten Sie eine Zusammenfassung Ihrer Unterdrückungsliste:

GET https://api.mail.land/v1/transactional/suppressions/stats

curl https://api.mail.land/v1/transactional/suppressions/stats \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "totalCount": 5000,
  "globalCount": 3000,
  "marketingCount": 1500,
  "transactionalCount": 200,
  "listCount": 300,
  "hardBounceCount": 2000,
  "softBounceCount": 1500,
  "complaintCount": 500,
  "unsubscribeCount": 700,
  "manualCount": 200,
  "invalidCount": 50,
  "spamTrapCount": 30,
  "roleAddressCount": 20,
  "expiringCount": 85,
  "lastSuppression": "2026-02-17T12:00:01Z"
}

Der Wert expiringCount zeigt Soft Bounces an, die innerhalb der nächsten 7 Tage ablaufen.

Prüfen, ob eine E-Mail unterdrückt istLink zum Abschnitt kopieren

EinzelprüfungLink zum Abschnitt kopieren

GET https://api.mail.land/v1/transactional/suppressions/[email protected]&messageType=Marketing

curl "https://api.mail.land/v1/transactional/suppressions/[email protected]&messageType=Marketing" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "email": "[email protected]",
  "isSuppressed": true,
  "messageType": "Marketing"
}

MassenprüfungLink zum Abschnitt kopieren

Prüfen Sie bis zu 1.000 E-Mails auf einmal:

POST https://api.mail.land/v1/transactional/suppressions/check-bulk

curl -X POST https://api.mail.land/v1/transactional/suppressions/check-bulk \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"emails":["[email protected]","[email protected]","[email protected]"],"messageType":"Marketing","mailingListId":null}'

{
  "emails": ["[email protected]", "[email protected]", "[email protected]"],
  "messageType": "Marketing",
  "mailingListId": null
}

{
  "suppressedEmails": ["[email protected]"]
}

Unterdrückung hinzufügenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/transactional/suppressions

curl -X POST https://api.mail.land/v1/transactional/suppressions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","suppressionType":"Manual","scope":"Global","reason":"Customer requested removal from all lists","notes":"Ticket #4521"}'

{
  "email": "[email protected]",
  "suppressionType": "Manual",
  "scope": "Global",
  "reason": "Customer requested removal from all lists",
  "notes": "Ticket #4521"
}

Gibt 201 Created mit dem vollständigen Unterdrückungsobjekt zurück. Der Location-Header lautet /v1/transactional/suppressions: die Listenroute, da es keinen Get-by-ID-Endpunkt gibt. Verwenden Sie das id-Feld im Antwortkörper, um die erstellte Unterdrückung zu identifizieren, sowie die Abschnitte „Unterdrückungen auflisten" oder „Prüfen, ob eine E-Mail unterdrückt ist" weiter unten, um sie nachzuschlagen.

MassenhinzufügungLink zum Abschnitt kopieren

Fügen Sie bis zu 1.000 Unterdrückungen auf einmal hinzu:

POST https://api.mail.land/v1/transactional/suppressions/bulk

curl -X POST https://api.mail.land/v1/transactional/suppressions/bulk \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"emails":[{"email":"[email protected]","suppressionType":"Manual","scope":"Global","reason":"Cleanup"},{"email":"[email protected]","suppressionType":"Manual","scope":"Marketing"}]}'

{
  "emails": [
    { "email": "[email protected]", "suppressionType": "Manual", "scope": "Global", "reason": "Cleanup" },
    { "email": "[email protected]", "suppressionType": "Manual", "scope": "Marketing" }
  ]
}

{
  "totalCount": 2,
  "addedCount": 2,
  "skippedCount": 0,
  "skippedEmails": [],
  "message": "Added 2 suppressions"
}

E-Mails, die bereits in der Unterdrückungsliste vorhanden sind, werden übersprungen (nicht dupliziert).

Import aus CSVLink zum Abschnitt kopieren

Aus TextinhaltLink zum Abschnitt kopieren

POST https://api.mail.land/v1/transactional/suppressions/import

curl -X POST https://api.mail.land/v1/transactional/suppressions/import \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"csvContent":"[email protected]\[email protected]\[email protected]","defaultReason":"Imported from legacy system","suppressionType":"Manual","scope":"Global"}'

{
  "csvContent": "[email protected]\n[email protected]\n[email protected]",
  "defaultReason": "Imported from legacy system",
  "suppressionType": "Manual",
  "scope": "Global"
}

Aus Datei-UploadLink zum Abschnitt kopieren

POST https://api.mail.land/v1/transactional/suppressions/import-file

curl -X POST "https://api.mail.land/v1/transactional/suppressions/import-file?scope=List&mailingListId=123" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -F "[email protected]"

Laden Sie eine .csv-Datei (max. 5 MB) mit E-Mail-Adressen hoch, die durch Kommas oder Zeilenumbrüche getrennt sind. Eine Kopfzeile mit "email" wird automatisch übersprungen.

Query-Parameter:

{
  "totalRows": 1000,
  "importedCount": 950,
  "skippedCount": 40,
  "invalidCount": 10,
  "invalidEmails": ["not-an-email", "missing-domain@", "..."],
  "errors": [],
  "message": "Imported 950 emails. 40 already existed. 10 invalid."
}

Unterdrückungen exportierenLink zum Abschnitt kopieren

Laden Sie Ihre Unterdrückungsliste als CSV herunter:

GET https://api.mail.land/v1/transactional/suppressions/export

curl https://api.mail.land/v1/transactional/suppressions/export \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -o suppressions.csv

Gibt eine CSV-Datei mit den Spalten zurück: email, type, scope, mailing_list, reason, bounce_count, source, created_at, expires_at. Begrenzt auf 100.000 Zeilen.

Unterdrückung entfernenLink zum Abschnitt kopieren

Nach IDLink zum Abschnitt kopieren

DELETE https://api.mail.land/v1/transactional/suppressions/{id}

curl -X DELETE https://api.mail.land/v1/transactional/suppressions/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Nach E-MailLink zum Abschnitt kopieren

DELETE https://api.mail.land/v1/transactional/suppressions/[email protected]

curl -X DELETE "https://api.mail.land/v1/transactional/suppressions/[email protected]" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Gibt bei Erfolg 204 No Content zurück, 404 wenn nicht gefunden.

Gesperrte UnterdrückungenLink zum Abschnitt kopieren

Bestimmte Unterdrückungen können nicht gelöscht werden, um Ihre Absenderreputation zu schützen und Anti-Spam-Vorschriften einzuhalten:

Der Versuch, eine gesperrte Unterdrückung zu löschen, gibt Folgendes zurück:

{
  "code": "SUPPRESSION_LOCKED",
  "message": "Cannot delete: Spam complaint - compliance requirement",
  "details": {
    "lockedReason": "Spam complaint - compliance requirement"
  }
}

AbmeldequellenLink zum Abschnitt kopieren

Wenn sich ein Empfänger abmeldet, wird die Quelle erfasst:

FehlerantwortenLink zum Abschnitt kopieren

Nächste SchritteLink zum Abschnitt kopieren

• Bounces: Bounce-Typen und automatische Unterdrückung verstehen
• Zustellbarkeitsübersicht: Absenderreputation überwachen
• Webhook-Events: message.bounced-Events empfangen (suppression.added/suppression.removed sind im Katalog definiert, werden aber heute nicht ausgelöst)