You can't send a draft through the subscriber endpoint

/v1/subscribers/{id}/emails now rejects non-final emails

June 27, 2024

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.

Breaking change: we've removed the ability to send non-final emails like drafts from /v1/subscribers/{id}/emails. Such requests will now return an error message:

{
  "code": "email_invalid_status",
  "detail": "You can't programmatically send emails with status 'draft'. Finalize the email first or use the /v1/emails/{id}/send-drafts endpoint instead.",
  "metadata": {
    "email_status": "draft",
    "email_id": "em_...",
    "subscriber_id": "sub_..."
  }
}

This is a breaking change, and apologies if you suddenly started getting 400s as a result of it, but the fix should hopefully be simple: just migrate that call to /v1/emails/{id}/send-draft instead.

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

Join your last newsletter platform