Introduction to the Sailthru API

Welcome to our updated API documentation! (Details here.)
We invite you to rate this page at the bottom or send feedback to docs@sailthru.com.

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

blast

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

blast_repeat

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

list

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

send

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

template 

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

preview 

Preview blasts and templates

trigger 

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

include

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

Reporting and User Data Management

job

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

user

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

event

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

stats

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

Content Library

content

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

Site Personalization Manager (Beta)

section

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.

block

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

purchase

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

Advertising

ad/plan

Update or get information on an Ad Targeter plan

Settings

settings

Display and change your settings

Technical Information

Top