settings

Retrieve or update settings for your company's account.

Endpoint URL: https://api.sailthru.com/settings


GET

No parameters are needed. The response will include all accessible settings.

Return Value

Copy
{
    "domains" : {
        "http://example.com" : {
            "link_domain" : "link.example.com",
            "horizon_domain" : "horizon.example.com",
            "site_domain" : "example.com"
        }
    },
    "from_emails" : [
        "news@example.com",
        "deals@example.com"
    ],
    "lists_primary" : [
        "Main List",
        "Weekly Newsletter"
    ],
    "timezone" : "America/New_York",
    "id" : 99999,
    "beacon_image" : "3sd/1jz/5/6/554a6b4fe0b2b.png",
    "apple-app-site-association" : {
        "link.example.com" : "https://link.example.com/apple-app-site-association"
    },
    "https-certificate-association" : []
}

Return data will include some or all of the following information:

Field Description
domains Array containing information about the domain or domains on file
from_emails Array containing a list of verified from emails
lists_primary Array containing lists designated as primary.
timezone Your account's time zone
id A unique identification number for your account
beacon_image Location of your account's beacon image
apple-app-site-association If you have configured Universal Links for one or more iPhone apps, this contains mappings for each of your link domains to its Apple App Site Association File.
 

POST

Update settings.

Add 'From' Email(s)

Example Call:

Copy
{
"from_emails" : ["news@example.com","deals@example.com"]
}

Upload Beacon Image

Example Call:

Copy
{
   "file" : "beacon.png"}

Replaces current beacon image. Send the beacon image data with your post call.

Manage Apple App-Site Association Files

Example: Add Apple App-Site Association File

Copy
{
 "link.example.com\/apple-app-site-association" : "Downloads\/apple-app-site-association"}

Example: Remove Apple App-Site Association File

Copy
{
 "link.example.com\/apple-app-site-association" : 0
}

Optional Parameters

Specify one or more the following parameters:

ParameterDescription
from_emailsArray of emails to add to your account as possible "From" emails for use with campaigns (blasts) or transactional sends. Each address will receive a confirmation email for verification purposes. The verification process must be completed before the address can be used.
fileLocation of a new beacon image you wish to upload
link.example.com\/apple-app-site-associationSpecify an Apple App-Site Association File to configure Universal Links for one or more iPhone apps. To complete the configuration, you will also need an SSL certificate uploaded through the interface. Replace link.example.com with your link domain.