BUbuttondown
Emails

Send Draft

Changed on

Send a draft email to specific recipients

post/emails/{id}/send-draft

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/emails/{id}/send-draft
  • Auth
    API key in header Authorization

Path parameters

idstring required

Request body

subscribersstring[] nullable

A list of subscriber ids to which to send the email.

recipientsstring[] nullable

A list of email addresses to send the email to.

Example request

{
  "subscribers": [
    "sub_01h8xg4j3k2m1n0p9q8r7s6t5v"
  ],
  "recipients": [
    "telemachus@buttondown.email"
  ]
}

Response

OK

Changes

  • 228cc05ba97dRevision changes
    • breaking

      added the pattern ^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:sub)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$ to the request property //

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 13f3bc084194Revision changes
    • breaking

      the response's property type changed from no type to string for status

    • breaking

      the response's property type changed from no type to string for status

    • breaking

      the response's property type changed from no type to string for status

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security PermissionAuthenticationRequirement was removed from the API

    • info

      api tag Emails added

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      added the non-success response with the status