How the -3 (Spam Complaint) Status Works
-
Status
-3means the mailbox provider reported a spam complaint. This is often triggered when the subscriber clicks "Report spam," but it can also result from provider feedback loops. -
When an address marks a newsletter as spam, Piano ESP suppresses all future delivery to that recipient.
-
Re-importing the address or re-adding it to a mailing list in the Dashboard will not restore delivery while the
-3flag remains in the backend.
Prerequisites to Reinstate a Subscriber
To clear a spam-complaint block, both of the following are required:
Subscriber Action: Unmark the Email as Spam
The subscriber must locate one of your messages in their Spam/Junk folder and take one of the following actions:
-
Click "Not spam", or
-
Move the message to the Inbox
This is important because it retrains the mailbox provider. If the email remains marked as spam, the provider may re-apply the complaint and the address can quickly return to -3.
Adding the sender to contacts or whitelists is helpful for deliverability, but it is not a substitute for marking the message "Not spam" or moving it to the Inbox.
Documented, Explicit Consent to Resubscribe
Because the subscriber was suppressed due to a spam complaint, you must collect explicit, written proof that they want to receive emails again (for compliance purposes). Acceptable examples include:
-
A reply email from the subscriber requesting to be resubscribed.
-
A screenshot showing their request.
-
A screenshot showing the "Not spam" action (if available).
Retain this documentation in your records.
Clearing the Spam Status
Once both prerequisites are met, submit a request to Piano Support to have the subscriber reinstated. Include the following in your request:
-
The subscriber's email address(es)
-
The mailing list / campaign ID(s) they should be added back to (only the lists they opted into)
-
The consent evidence described in this section
After validation, the ESP backend team will:
-
Clear the spam-complaint flag in the database.
-
Re-add the subscriber to the specified mailing list(s).
This step requires a backend update and cannot be completed solely in the ESP Dashboard.
Optional: Subscriber Self-Resubscribe
If the subscriber can access an older email from the same campaign, they may be able to use the footer link flow:
-
Click Unsubscribe in the email footer.
-
Use the option to Re-subscribe (if presented).
Even when using this flow, if the subscriber is -3, backend clearance may still be required depending on the situation. Always ensure the "Not spam" step described in this section is completed first.
Verifying the Subscriber Is Active Again
After Piano Support confirms the update, verify the subscriber's status in the ESP interface:
-
Navigate to Emails → Mailing lists.
-
Open the relevant mailing list.
-
Download the list CSV.
-
Confirm the subscriber shows Status
1(active/subscribed).
Troubleshooting
|
Issue |
Explanation |
|---|---|
|
The subscriber cannot find any messages in their Spam/Junk folder. |
They may be blocked or filtered upstream. Ask them to check mailbox rules and filters. If needed, contact their mailbox provider (postmaster/support) to confirm there is no block in place. |
|
You re-imported the address but it still does not receive emails. |
This is expected while the backend |
|
The address was cleared once but became |
This commonly happens when the subscriber did not complete the "Not spam" or move-to-Inbox step before reinstatement. The mailbox provider re-applied the complaint. |
Related Status Code: -2 (Hard Bounce)
If you see status -2, it indicates a hard bounce (e.g., invalid or undeliverable address). Like -3, it cannot typically be fixed by Dashboard actions alone.
Visit this article for more details about this status and how to resolve any related issues.