The changelog provides a list of dated updates, each of which contains a number of potentially backwards-incompatible changes. There is no explicit versioning in the API at this time; all changes will be either compatible or breaking. (If I attempt any brittle changes to the API that may break current implementations, I'll be sure to add version gates.)


You can now filter emails by creation_date and publish_date in the /v1/emails endpoint.


Added /v1/webhooks, which allows you to create and list webhooks that will be called when certain events happen in your account.


Added utm_campaign, utm_medium, and utm_source to the /v1/subscribers endpoint. If these fields are not present, the values will be inferred from a provided referer_url.


Added /v1/email/:id/analytics, which returns aggregated information about opens, clicks, and other events for a given email that you've sent.


Removed the /v1/drafts, /v1/scheduled-emails, and /v1/unsubscribers endpoints. The behavior of all three endpoints have 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 subscriber_type='unsubscribed'


Added support for filtering emails in /v1/emails/ on included_tags and excluded_tags.


Took the ability to send specific emails to subscribers out of beta; added /v1/subscribers/<id>/send-reminder, which allows you to send reminders to your subscribers to confirm their email address.


Added support for Exports via the /v1/exports endpoint.


Added support to set and retrieve metadata on Emails.


Added deletion and update abilities to the Scheduled emails endpoint, giving you much more programmability than the hitherto append-only state of the world.


Added a deletion endpoint to the Images endpoint, allowing you to delete unused images.