Sailthru Blog » API

API HTTP Error Codes

Ian White — Thu, 12 May 2011 18:15:40 +0000

For a while, our API wasn’t as RESTful as it could be. That’s because we didn’t make use of HTTP header codes.

Unless the API was truly down, we would always return 200 OK, and use a Sailthru Error Code to denote the exact type of error.

After reviewing our existing client libraries to make sure this change would be a non-breaking change, we’ve added proper HTTP response codes on errors. This gives you a broader, more general insight into what’s wrong, and will work well with general HTTP transport mechanisms.

For example, if you try to send to a template that doesn’t exist, you’ll continue to get a Sailthru error 14 (“Unknown template”) in the body of the returned response, but you’ll also receive a 404 Not Found in the header of the HTTP request.

We hope this helps our easy-to-integrate API get that much easier. If you have any questions or comments, feel free to email us any time.

Paradise by the Dashboard

noah — Mon, 04 Oct 2010 20:51:01 +0000

As part of the ongoing redesign of our user interface, we’ve just rolled out a new dashboard feature. Now, when you sign in to your Sailthru account you’ll be presented with selected metrics that provide a clear and quickly digestible window into your account performance.

Ain't no doubt about it. Baby, got to go out and shout it!

In the example pictured above you’ll notice charts displaying list member growth and engagement, mass and transactional send rates as well as campaign results. The graphs on the left are customizable, allowing you to select durations from one day up to the entirety of your account history. On the right side of the dashboard is a pie graph depicting member activity by engagement as well as ledgers showing recent campaign results and scheduled campaigns. (For more information on understanding engagment see engagement tags.) For clients who only send transactional emails the dashboard will default to a display which shows only those applicable email metrics.

To navigate back to the dashboard from elsewhere in the site, just click on the Sailthru logo and, bam! you’re back. We hope you’ll find the new dashboard useful, but this is just the first step: in the coming weeks we’ll be adding more functionality to the dashboard, as well as making it more customizable and deeply drillable. We’re working hard to make our interface as intuitive, informative and revealing as possible, and we would love to hear what you think.

“text only” test send

noah — Fri, 23 Jul 2010 18:29:03 +0000

For clients who want to preview how their emails will be rendered by text only email clients our “text only” feature allows them to test send text only versions of their emails. When editing a campaign or template, simply select the “text only” box and test send to the emails of your choosing.

Now try and say “test send text only” five times fast.

API Library updates

Neil Capel — Thu, 30 Oct 2008 19:08:04 +0000

To make intergrating us a simple as possible we’ve added libraries to work with our API.

Current approved libraries include:

We also have the following in beta release (send us an email to get a hold of them):

Python
Java

We’d love a PERL version too so if you want free service for a month please provide the PERL library!