We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

"Not Delivering to a User Who Marked Your Messages as Spam"

Ever received an avalanche of email from someone? Not exactly what you might call the most enjoyable experience. When this happens, we naturally might get tired of the sheer volume of emails and want to unsubscribe.  But what if the unsubscribe is ignored, or there isn't even a clear way to unsubscribe in the first place? Perhaps you're just fed up and want to end this madness right now?  You'll likely simply mark the message as spam to make a clean break. 

Unbeknownst to you, that's exactly what your customer, Tim the Enchanter, did.  Tim received a ton of Black Friday emails from you this year and decided that enough is enough; spam button pressed! During your yearly Black Friday sale, you notice that sending to Tim is now encountering issues.  Being a savvy Mailgun user, you check your Mailgun Logs (or alternate monitoring method), and you notice Tim's email failed with the message "Not delivering to a user who marked your messages as spam." 

So, what does this error mean; can Tim the Enchanter still receive emails from you?  Don't worry - we'll explain everything you need to know below!

TL;DR Overview

If the recipient marks your message as spam, the rule is that you need to honor their decision of strongly rejecting your emails. The exception, however, is either if the recipient specifically reaches out to you stating the complaint was made in error, or if the recipient later opts-in to receive emails once again. In these specific cases, the recipient should opt-in once again to your emails and you may then remove their address from the Mailgun Suppressions list.  Removing the email address from the Suppressions list of the Mailgun Control Panel will allow delivery of new messages to said address.

The Cause

This error indicates that the email address is currently suppressed by our system from further delivery attempts. Why? Because sometime after receiving one of your emails, the recipient decided they no longer wish to receive any further emails from you, so they marked the message as spam or junk in their email application.  When the recipient takes this action, their email provider generates a complaint and sends it to the sender's email provider (in this case, Mailgun).  When this happens, we suppress the address internally to protect the reputation of your domain, and that of our IPs. Additionally, we do this to comply with international laws and regulations. Sending to recipients who no longer wish to receive emails possibly violates numerous laws and regulations and severely damages your deliverability; this is spammer behavior, after all.

The Solution

The solution depends on the reason behind the cause: did the recipient intentionally or unintentionally complain about your messages by marking them as spam?  Nearly always, the recipient's complaint is intentional. As such, you really shouldn't just remove their address from the Suppressions; you need to stop emailing them any further. (An important point: if the recipient opts-in to receive your emails once again at a later date, their address can be removed from the Suppressions list).  In some seldom-seen cases, the recipient's complaint is unintentional. When this happens, if they reach out to you explicitly stating the complaint was unintentional, the recipient should opt-in once again to your emails while you remove that recipient from the Suppressions.

In the case that removing the address from Suppressions is warranted, you can remove them from the list via your Mailgun control pane, or via the Complaints API, using an HTTP DELETE request. 

If you're using the classic UI (options across the top, with a silver background), use the following instructions:

  • Click on the Suppressions tab near the top of the Mailgun dashboard.
  • Choose the Complaints suppression type.
  • Click the checkbox next to the recipient and then click the Delete button to remove the Suppression.

If you're using the beta UI (options displayed down the left-hand side on a dark column) use these instructions:

  • Click on the Messages option on the left-hand side of your Mailgun dashboard and then select Domains.
  • Click on the specific domain for which you would like to view the Suppressions.
  • You will click on the Suppressions tab near the top of the screen.
  • Choose the Complaints suppression type, and then click Delete button on the right-hand side of the specific suppression you would like to delete.

 

Lastly, to read more about Suppressions, please see this related help article. If any questions arise, just reach out to our Support team via the Support tab in your Mailgun control panel!

Getting Started Sending Mail Receiving Mail Deliverability & Reputation Email Tracking Troubleshooting
Powered by Zendesk