Erforderliche Berechtigung: subscribers
Bounce-Typen
| Type | Description | Action |
|---|---|---|
hard |
Permanenter Zustellungsfehler (nicht existierende E-Mail) | Sofortige Abmeldung |
soft |
Vorübergehender Zustellungsfehler (Postfach voll usw.) | Abmeldung nach 3 Wiederholungen |
complaint |
Spam-Meldung | Sofortige Abmeldung |
GET
/api/v1/bounces
Ruft die Bounce-Liste ab.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit |
integer | Anzahl der Ergebnisse (Standard: 20, Max: 100) |
offset |
integer | Paginierungs-Offset |
Response
{
"success": true,
"data": {
"bounces": [
{
"id": 1,
"email": "invalid@example.com",
"bounce_type": "hard",
"bounce_subtype": "NoEmail",
"source": "ses",
"campaign_name": "January Newsletter",
"subscriber_name": "John Doe",
"created_at": "2026-01-10T12:00:00Z"
}
],
"total": 50,
"limit": 20,
"offset": 0
}
}
POST
/api/v1/bounces
Meldet manuell einen Bounce.
Request Body
{
"email": "invalid@example.com",
"bounce_type": "hard", // hard, soft, complaint
"bounce_subtype": "NoEmail", // optional
"diagnostic_code": "550 5.1.1..." // optional
}Response
{
"success": true,
"data": {
"bounce_id": 123
}
}E-Mail-Provider-Webhooks
Sie können automatisch Bounce-Benachrichtigungen von E-Mail-Providern wie AWS SES, Mailgun, SendGrid usw. empfangen.
Webhook-URLs
| Provider | Webhook URL |
|---|---|
| AWS SES (SNS) | https://dev.mailpass.im/api/v1/webhooks/ses |
| Mailgun | https://dev.mailpass.im/api/v1/webhooks/mailgun |
| SendGrid | https://dev.mailpass.im/api/v1/webhooks/sendgrid |
AWS SES-Einrichtung
- Erstellen Sie ein neues Topic in AWS SNS.
- Fügen Sie dem Topic eine HTTPS-Subscription hinzu:
https://dev.mailpass.im/api/v1/webhooks/ses - Erstellen Sie ein Configuration Set in AWS SES.
- Fügen Sie dem Configuration Set ein Event Destination hinzu und wählen Sie das SNS Topic aus.
- Wählen Sie Bounce- und Complaint-Ereignisse aus.
Bounce-Verarbeitungsrichtlinie
- • Bei einem Hard Bounce wird der Abonnent sofort auf den Status 'bounced' gesetzt.
- • Bei 3 aufeinanderfolgenden Soft Bounces wird es als Hard Bounce behandelt.
- • Bei einer Spam-Meldung wird der Abonnent auf den Status 'unsubscribed' gesetzt.
- • An gebounced E-Mail-Adressen werden keine E-Mails mehr gesendet.
Best Practices
- • Halten Sie die Bounce-Rate unter 5%. Eine hohe Bounce-Rate wirkt sich negativ auf die Absenderreputation aus.
- • Überprüfen Sie regelmäßig die Bounce-Liste und bereinigen Sie ungültige E-Mails.
- • Verwenden Sie Double Opt-in, um nur gültige E-Mails zu erfassen.
- • Erwägen Sie eine Echtzeit-Validierung bei der Erfassung von E-Mail-Adressen.