What action options does Valid Email Checker offer for Mailgun? (Tag / Unsubscribe / Delete)

Last updated May 20, 2026Integrations

When you pick a Mailgun Mailing List and switch the Valid Email Checker modal to Clean List Automatically, three actions become available per result category. The dropdown labels read Keep, Unsubscribe, and Delete. The category rows are the same across every integration (Invalid, Disposable, Catch-all, Unknown, Risky). What changes is how each action lands inside Mailgun.

How each action behaves

  • Keep — VEC writes nothing back. The Mailing List member stays put. Member variables (Mailgun custom fields), subscription state, and historical activity are untouched.
  • Unsubscribe — VEC calls the Mailgun API to set the member to Unsubscribed on the Mailing List. They remain a member of the list but stop receiving any further broadcasts. Member variables and historical activity are preserved.
  • Delete — VEC removes the member from the Mailing List entirely. Member variables go with them. Transactional sending history (in Mailgun logs, not Mailing Lists) is untouched.

Default settings

The defaults match every non-ConvertKit integration. Only the two unambiguously bad categories are enabled out of the box.

CategoryEnabled by default?Default action
InvalidYesUnsubscribe
DisposableYesDelete
Catch-allNoKeep
UnknownNoKeep
RiskyNoKeep

The Use Recommended Settings link snaps the panel back to defaults. Pair with the list selection in how to select a Mailgun list to verify.

Transactional vs. Mailing List separation

Cleanup actions only affect the Mailgun Mailing List you verified. The underlying email logs, your transactional sending suppression list, and your domain reputation tracking are independent. If you want to add invalid addresses to your Mailgun account-wide suppression list, use the Mailgun dashboard separately after the cleanup runs.

What survives Unsubscribe

  • Member variables (Mailgun custom fields stored as JSON per member) — preserved.
  • List membership — the member stays in the Mailing List, just marked Unsubscribed.
  • Historical broadcast activity — preserved in Mailgun logs.
Delete is per-list
Deleting a member from one Mailing List does not remove them from other Mailing Lists they might be in, nor does it suppress them from transactional sends. For account-wide suppression, use Mailgun's Suppressions feature directly.

Why the title says Tag and the UI says Keep

Tag/Unsubscribe/Delete is industry shorthand. Valid Email Checker uses Keep in the actual UI because that label honestly describes what happens — nothing. Some vendors silently tag every member with their results; VEC leaves your Mailgun Mailing List alone unless you explicitly choose Unsubscribe or Delete on a category.

The Risky category on Mailgun

Risky bundles risky, spamtrap, and role_account from the engine. Mailgun deliverability is monitored at the domain and account level, and spam traps damage it quickly. Enabling Risky with Unsubscribe protects your reputation while preserving member variables and historical logs.