How can I get notified when an email address is blacklisted or experiences a bounce?

Pushwoosh provides ways to track email bounces (which includes blacklisting due to hard bounces):

1. bouncedEmails API Method:

   • You can use the /statistics/emails/bouncedEmails API endpoint to retrieve a list of bounced emails (both hard and soft bounces) within a specified time period.
   • This method returns the email address, the bounce type (hard/soft), and the reason provided by the receiving mail server.
   • Regularly calling this API (e.g., daily) allows you to monitor bounces proactively.
   • API Documentation: Message Statistics API - bouncedEmails

2. PW_EmailBounced Event (Customer Journey):

   • Pushwoosh automatically triggers a default event named PW_EmailBounced whenever an email bounce occurs.
   • You need to manually create this event within your Pushwoosh project settings first. It supports two string attributes: email and reason.
   • Once created, you can use this event as a trigger in a Customer Journey.
   • Set up a Journey that starts with the PW_EmailBounced event and uses a 'Send Webhook' action to instantly notify your system whenever a bounce happens, providing the email address and bounce reason.

Understanding Bounces:

* Hard Bounce: Indicates a permanent delivery failure (e.g., invalid email address). Pushwoosh automatically stops sending to addresses that result in a hard bounce (effectively blacklisting them).

* Soft Bounce: Indicates a temporary delivery issue (e.g., mailbox full, server temporarily unavailable). Pushwoosh does not automatically blacklist based on soft bounces, but multiple soft bounces might indicate underlying deliverability problems.