Buttondown logo

Introduction2025-11-152025-09-232025-09-182025-07-282025-07-132025-06-262025-06-012025-05-302025-05-192025-05-172025-05-142025-04-172025-04-142025-03-312025-03-252025-03-012025-02-262025-02-122025-02-062025-01-022024-12-312024-12-302024-12-142024-12-112024-12-102024-12-092024-12-052024-09-302024-08-152024-08-012024-07-132024-06-272024-06-212024-05-222024-04-032023-08-232023-08-212023-07-232022-11-242022-11-192022-03-082021-11-262021-08-272021-01-022020-12-232020-12-09
Buttondown logo

2024-06-27

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": "{{ email.id }}",
    "subscriber_id": "{{ subscriber.id }}"
  }
}

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.

Stay informed

You can subscribe to this changelog via RSS or browse the full list of API changes.