Drafts, scheduled emails and unsubscribers fold into two endpoints

Removed /v1/drafts, /v1/scheduled-emails and /v1/unsubscribers

November 19, 2022
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.

Removed the /v1/drafts, /v1/scheduled-emails, and /v1/unsubscribers endpoints. The behavior of all three endpoints has been subsumed into /v1/emails and /v1/subscribers:

  • you can create (or list) drafts by specifying status='draft'
  • you can create (or list) scheduled emails by specifying status='scheduled'
  • you can list unsubscribers by specifying type='unsubscribed' (note: this field was renamed from subscriber_type to type in 2024-08-01)
Buttondown is the last email platform you’ll switch to.