MailingCore
DocumentationBounces and complaints

Bounces and complaints

Hard bounce suppression, SES webhooks, and email.bounced events.

MailingCore classifies delivery failures from AWS SES and updates your suppression list automatically.

Bounce types

TypeSMTPAction
Hard bounce5xx permanentEmail suppressed automatically — no future sends
Soft bounce4xx temporaryLogged; may retry on next send
ComplaintFBL/ARFEmail suppressed + notification
Spam reportISP reportEmail suppressed

SES inbound flow

AWS SES → SNS notification → MailingCore SES webhook handler
         → update EmailLog status
         → hard bounce / complaint → Suppression table
         → emit webhook email.bounced / email.complained

Configure SES feedback notifications to MailingCore's SNS endpoint (managed in platform setup).

Outgoing webhooks

Register an endpoint to receive real-time events:

EventWhen
email.bouncedHard or soft bounce (check payload bounceType)
email.complainedRecipient marked as spam
email.deliveredSuccessful delivery confirmation

See Event catalog and Verify signature.

Example email.bounced handling

// Your webhook handler
if (event.type === 'email.bounced' && event.data.bounceType === 'HARD') {
  await markContactInvalid(event.data.toEmail)
}

Dashboard and API

  • View bounced sends in Emails → Logs (status: BOUNCED)
  • Query via Email logs
  • Manage suppressions: GET/POST/DELETE /suppressions

Related