This call allows the user to upload a Transient Suppression List.


JSON Request Example


/**
 * Newsletters::UploadTransientList
 */
{
  "username": "matbt@pinpointe.com",
  "usertoken": "5eb8449c1a788fc27c955f8966dd495f519bd72f",
  "requesttype": "Newsletters",
  "requestmethod": "UploadSuppressionTransientList",
  "details": {
    "name": "{*transient_list_name*}",
    "contacts": [
      "{*email_address OR md5_hash_of_email_address*}",
      "{*email_address OR md5_hash_of_email_address*}"
    ],
    "ttl": "{*int_time_to_live*}"
  }
}
Null

"json_request" element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeNewsletters
requestmethodUploadSuppressionTransientList


"details" element


Field NameDescription
name
(Required)
Name of the Transient Suppression List 
contacts
(required)

Emails address that populate the Transient Suppression List; (email address, md5 hash of email address)
ttl
(required)
Time to Live is the number of days until the list expires from when it's created; default is 30. 


Please note: ALL OPTIONAL elements that are not used should be deleted from submitted call. 


Successful Response:


"response" element


Field NameDescription
statusWill return SUCCESS if the journey has been successfully created
dataListid, count, failures, duplicates, and total of the uploaded Suppression Transient List.


Unsuccessful Response:


"response" element


Field NameDescription
statusWill return FAILED if unsuccessful
errormessageText explaining why request failed