Mailchimp integration: connect via OAuth, verify audiences, clean automatically
Mailchimp is one of two integrations that use OAuth (HubSpot is the other) — meaning you authorize the connection through a one-click redirect, no API key to find or paste. The rest of the connect flow and verification options match the standard integration pattern. This guide covers Mailchimp-specific details on top of the integrations overview.
Connecting Mailchimp
- In your dashboard, go to Bulk Upload → Connect Email Platform → Mailchimp.
- Optionally name the connection (default is "My Mailchimp Account").
- Click Connect with Mailchimp. You are redirected to Mailchimp's OAuth authorization page.
- Sign in to Mailchimp if not already signed in.
- Review the read/write permissions we request (read audiences and members; write unsubscribe/delete to apply cleanup actions).
- Click Allow. You are redirected back to our dashboard with Mailchimp showing as connected.
OAuth-based connections do not store an API key on our side — we hold an OAuth token that can be revoked from your Mailchimp account at any time (Settings → Integrations).
What you can verify
Mailchimp exposes two list-like structures:
- Audiences — top-level subscriber containers. Most Mailchimp users have one or two.
- Segments — subsets of an audience defined by filters or tags. Useful for verifying just engaged subscribers, just recent signups, or just contacts in a specific country.
The list picker shows all audiences and segments with their subscriber counts. Picking a segment verifies only the members of that segment, which is the cheapest way to do regular list hygiene on a large Mailchimp account.
Clean-list defaults for Mailchimp
Standard across all integrations:
| Category | Enabled by default? | Default action |
|---|---|---|
| Invalid | Yes | Unsubscribe |
| Disposable | Yes | Delete |
| Catch-all | No | Keep |
| Unknown | No | Keep |
| Risky | No | Keep |
In Mailchimp, Unsubscribe updates the contact status to "Unsubscribed" (they stop receiving emails but remain in the audience). Delete removes the contact from the audience entirely. Tags, merge fields, and signup metadata are preserved for kept and unsubscribed contacts.
Multiple Mailchimp accounts
Agencies and businesses with multiple Mailchimp accounts (one per client, one per region) can connect more than one. Bulk Upload → Connect Email Platform → Mailchimp → Add Another Account. Each connection authorizes against a different Mailchimp login.
Common Mailchimp issues
"OAuth authorization failed"
Two common causes:
- You need owner or admin permissions in the Mailchimp account to authorize third-party apps. Manager and Author roles cannot grant the required scopes.
- Browser blocked the OAuth redirect. Some strict-privacy browsers block cross-domain auth flows. Try a different browser or temporarily allow third-party cookies on
app.validemailchecker.com.
"Cleanup ran but Mailchimp still shows old subscribers"
Mailchimp processes external API writes asynchronously. After Clean List Automatically completes on our end, give Mailchimp 2-5 minutes to reflect the changes. If contacts are still showing 30 minutes later as if no cleanup ran, contact support — we can check the API response on our side.
"Some contacts could not be removed"
Mailchimp prevents deletion of contacts that are part of an active automation. Those contacts stay in the audience and are marked unsubscribed (the next-best cleanup action). The verification result file shows which addresses were affected.
Cost
1 credit per address verified, same as any other path. If you pick a 50,000-subscriber audience, the verification costs up to 50,000 credits (less, after duplicate removal). Picking a smaller segment (e.g., "added in the last 30 days") is the right move for ongoing monthly hygiene.
Next steps
Related questions
Still stuck? Email support
