Introduction to the Sailthru API

The Sailthru API allows you to interact programmatically with an array of Sailthru features and data sets. For example, add users, send campaigns, push and update content in realtime, and more.

The Sailthru API is a REST-based service. You can get a kickstart with our language-specific Client Libraries and reference our full API endpoint documentation below. Some common uses for our API:

  • Send individual email messages – For example, automated welcome emails, purchase confirmation emails, or other transactional messages. Use the Send and Template calls. See also: Transactional Emails.
  • Send email campaigns – Schedule delivery to multiple recipients. For example, a daily or weekly newsletter. Use a Blast call. See also: Campaigns, Lists.
  • Set user data or list subscriptions – Subscribe users to or unsubscribe users from your lists. Add or update data for any user. See the User call. See also: List Management.
  • Perform data processing tasks – For example, imports of subscriber lists, bulk user data updates, and exports of user data. Use the Job call to start a job or check its status.

To Get Started

  • Review the API Endpoints below.
  • View the Client Library for your preferred language, or learn how to build your own calls with curl on the Technical Details page.
  • If you want a quick way to test a call, you can submit it in My Sailthru on the API Test Page.

API Endpoints

Click an endpoint name to view its reference documentation.

Email Delivery and Subscription Management


Schedule or check the status of a Regular Campaign (mass mail blast). See also: Campaigns


Create or update a Recurring Campaign (mass mail blast). See also: Campaigns


Create lists or update the subscription status of entire lists of users. See also: Creating Lists, Integrate Lists, Setting Variables


Send, check status or delete triggered transactional email. See also: Transactionals


Create or edit templates for your triggered mail. See also: Template OverviewOptimize Templates


Preview blasts and templates


Create / update / delete transactional trigger. See also: Sending Triggers for Transactionals


Create “includes”; reusable HTML or text snippets for email templates, such as headers and footers.

Reporting and User Data Management


Covers several actions including importing / updating / exporting subscribers, getting stats from sent email campaigns, and querying your subscriber analytics in aggregate.


Add/change/merge identifying keys to user profiles and query by engagement.


Send realtime user behavior and associated data to Sailthru. When called, events can initiate specific Lifecycle Optimizer flows, Smart Strategies tactics, or Sailthru Triggers.


Request summary stats about your subscribers, email campaigns, and transactional emails.

Content Library


Add or update content in your Content Library. See also: Personalization Engine in Email.

Site Personalization Manager (Beta)


Create or update sections of your website for site personalization. Further enhancements are coming to this API. Please check with your Salithru representative before implementing.


Store templates (including Zephyr code and HTML) to configure section display. Further enhancements are coming to this API. Please check with your Sailthru representative before implementing.

E-commerce Data


Various aspects of e-commerce from recording an e-commerce shopping cart or checkout event to tracking abandoned shopping carts



Update or get information on an Ad Targeter plan



Display and change your settings

Technical Information