Removed deprecated subscriber types

spammy, malformed and disabled are gone from the SubscriberType enum

July 28, 2025
Breaking API change

This is a backwards-incompatible change to Buttondown's API. Pinning your newsletter or request to an older API version keeps the previous behavior where a version was cut for it.

We've simplified the SubscriberType enum by removing the following deprecated types:

  • spammy — now consolidated into undeliverable with a specific undeliverability_reason
  • malformed — now consolidated into undeliverable with undeliverability_reason of malformed
  • disabled — this type has been removed entirely

This change streamlines subscriber management by using the existing undeliverability_reason field to provide more granular information about why a subscriber cannot receive emails, rather than having separate top-level types.

If you were filtering subscribers by subscriber_type=spammy, you should now filter by subscriber_type=undeliverable instead. The specific reason for undeliverability can be determined by checking the undeliverability_reason field.

Buttondown is the last email platform you’ll switch to.