Undeliverable email addresses

What happens when mail to a customer's address permanently bounces or is reported as a complaint, what the customer sees, and how an operator clears the mark.

For: Workforce Intelligence operators (portal users whose email domain is on the operator list) · Last updated

Workforce Intelligence sends account email (sign-up confirmation, password reset and billing notices) through Amazon SES. When mail to an address permanently bounces, or its recipient reports it as unwanted, central marks the address undeliverable and stops mailing it.

What marks an address#

  • A permanent bounce: the address does not exist or refuses mail for good.
  • A complaint: the recipient reported a message as unwanted.

Temporary problems, such as a full mailbox, do not mark anything. The marking happens within minutes: a scheduled job reads bounce and complaint reports from SES and sets the mark on the matching sign-in record. Marking the same address twice, or reports arriving out of order, changes nothing more. An address SES reports that has no account here is ignored.

What the customer sees#

  • A signed-in customer sees a notice at the top of the portal: "We could not deliver email to the address on this account, so we have stopped sending to it. Messages such as password resets will not reach you. To fix this, contact us" with our contact address.
  • Someone who is not signed in and signs up or asks for a confirmation link with that address sees the same "check your email" page as for any other address, so the page never reveals which addresses have an account. No message is sent to the marked address. They are told only by the notice above once they sign in, or by you when they contact us.

Clear the mark#

Clear the mark only after the customer has confirmed the address works.

  1. Open the account from Accounts. A section titled "The owner's email address is not receiving mail" shows whether the address bounced or drew a complaint, and the date.
  2. Turn on operator mode first; while it is off the page shows a note instead of the button. Then select Send email again, then confirm. Account messages go to the address again. If it fails again, it is marked again.

Clearing an address that is not marked changes nothing. The action is audited as account.clear_undeliverable, with the account id and no email address. A report that SES published before you cleared the mark does not mark the address again.

SES keeps its own suppression list. If an address is on it, SES refuses to send even after you clear the mark; remove the entry from the list in the SES console.

What is recorded#

Action When
account.clear_undeliverable You clear the mark.

The account's history records when an address is marked (with only the reason, bounce or complaint) and when you clear it.