Help for owners
My sync marked Mailchimp contacts as unsubscribed or archived by mistake
Short answer
Mailchimp keeps a contact's status as a record of consent. The API accepts unsubscribed as a status, so a sync can set it by mistake, but a contact who unsubscribed themselves has to opt in again through your Mailchimp-hosted signup form. Stop the sync first, then sort the contacts by how they became unsubscribed.
Does this sound like your situation?
- Many active customers now show as unsubscribed in Mailchimp.
- My sync reports success but those contacts are still not subscribed.
- Contacts I archived, or the sync archived, are missing from my audience.
- Contacts show as cleaned and I do not know why.
- My audience count dropped after a sync or an import.
Why does this happen?
A sync can send the status unsubscribed
The Mailchimp API accepts subscribed, unsubscribed, cleaned, pending and transactional as the status of a list member. An integration that maps a field such as 'no marketing consent' or 'inactive' in your own system to unsubscribed will change the contact in Mailchimp.
Confirmed by mailchimp.com
Mailchimp treats a self-unsubscribe as the contact's decision
Mailchimp's help states that a contact who unsubscribed themselves cannot be resubscribed by you manually and has to sign up again through your Mailchimp-hosted signup form. Contacts you unsubscribed yourself in bulk for audience maintenance can be resubscribed manually.
Confirmed by mailchimp.com
Cleaned means the address failed delivery
Cleaned contacts come from hard bounces and repeated soft bounces. Mailchimp says they cannot be edited, and the documented route is to add a corrected address as a new contact. A valid address can occasionally hard bounce.
Confirmed by mailchimp.com
Archived is a separate state
Archived contacts are moved out of the audience into a separate table. Their data is kept but the profile cannot be edited, and they do not count as contacts you can email. Mailchimp says archived contacts can be unarchived.
Confirmed by mailchimp.com
What can I do about it today?
- Switch the sync offTurn off the integration or the schedule that writes to Mailchimp, so it cannot change more contacts while you look.
- Export the audience before touching anythingMailchimp exports a separate file for each status, and the file name shows the status. Keep the files as a record of the damage. Only Owners and Admins can export, and exports stay available for 30 days.
- Count who is affectedIn the audience, filter by status and by the date the status changed. Write down how many people moved and when it started.
- Separate the two groupsContacts that the sync unsubscribed or that you unsubscribed in bulk, and contacts who clicked an unsubscribe link themselves. The second group must not be re-added by any tool.
- Do not re-import unsubscribed people to force them backRe-adding someone who opted out can break Mailchimp's terms and the law where you sell. Ask your developer to read the rules, and to use a signup form for those who need to opt in again.
When should I bring someone in?
- You cannot tell which contacts unsubscribed themselves and which were changed by the sync.
- The integration keeps changing statuses on every run.
- You have customers in a country with consent rules, such as the EU or UK, and need the changes reviewed before anything is reversed.
How do I handle it?
- Read what the sync writesI read the mapping between your system's fields and the Mailchimp status, and find the rule that set unsubscribed or archived.
- Sort the contacts by causeUsing the exports and the activity history, I split contacts into changed by the sync, unsubscribed by themselves, cleaned by bounce, and archived.
- Restore only what Mailchimp's own rules allowContacts that were wrongly changed and can be changed back are restored through the paths Mailchimp documents. Self-unsubscribed contacts stay out unless they opt in again.
- Make the sync stop overwriting consentThe sync is changed so that Mailchimp stays the source of truth for opt-outs, and a status is never sent unless a person's action in your system really means it.
- Add a check before each runA report of how many statuses a run is about to change, with a stop if the number is far larger than usual.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Can the API simply set everyone back to subscribed?
The API accepts subscribed as a value, but Mailchimp's own help says a contact who unsubscribed themselves has to opt in again through your signup form. I read what the current API documentation says for your case rather than assume, and I do not work around a person's opt-out.
Are archived contacts deleted?
No. Mailchimp says archived contacts are moved to a separate table, their data is kept, and they can be unarchived.
Do cleaned contacts cost me money?
Mailchimp states that cleaned contacts do not count toward audience limits and that it does not charge for them. Check your own plan page for how billing is counted.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.