Confirmation emails when re-adding an unsubscribed subscriber

POST /v1/subscribers with collision-behavior add now respects type unactivated

August 14, 2026
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.

POST /v1/subscribers with X-Buttondown-Collision-Behavior: add will now respect passing type: unactivated and will send a confirmation email instead of going directly to type: regular when passing an unsubscribed email address.

See Creating a subscriber for the full add vs overwrite distinction.

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