REST Email Marketing API Documentation

DOCUMENTS — TEST SEND

Perform mail merging on a document and send it to the specified email address. This version takes just a few arguments. To provide DynamicTags use the POST version.

HTTP VERB

Put

URL

/API/Rest/Documents/TestSend

ARGUMENTS

documentName
emailAddress

Required permission

ViewDocument

ERRORS

No Permission
Invalid email address
Invalid document name
Invalid document type
No DNS MX entries for this domain
No virtual IP address configured
Unable to find a address that can be used for sending
An error occurred attempting to mail merge
Unable to retrieve dynamic mail merge data
The receiving mail server did not accept the mail, returning a message indicating the IP address has been blocked
The receiving mail server did not accept our attempt to connect
The receiving mail server returned a temporary failure code, implementing a strategy called "greylisting"
The receiving mail server said the mailbox is full
The receiving mail server did not accept the mail, complaining about too much email being sent, but saying that you could try again later
The receiving mail server rejected the mail, categorizing it as SPAM
The receiving mail server rejected the mail saying that the email address is unknown
The receiving mail server rejected the mail for an unknown reason
Database error
Unknown error

RETURNS

The document was accepted by the receiving mail server

EXAMPLE

Send a test document.

string url = "http://example.com/api/rest/Documents/TestSend/?accountName=acme&login=ApiUser&emailAddress=joe@example.com&documentName=TestDoc";
								
try
{
	System.Net.HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
	request.Headers.Add("Password", "sdjks8fsdysgd7");
	request.Method = "PUT";
	request.ContentLength = 0;
	using (System.Net.WebResponse response = request.GetResponse())
		using (Stream responseStream = response.GetResponseStream())
			using (StreamReader reader = new StreamReader(responseStream, Encoding.UTF8))
				System.Console.WriteLine(reader.ReadToEnd());
}
catch (System.Net.WebException ex)
{
	System.Diagnostics.Debug.Fail(ex.Message);
}
							

# encoding: utf-8
require 'rest-client'
require 'json'
							
url = 'http://example.com/api/rest/Documents/TestSend/?accountName=acme&login=ApiUser&emailAddress=joe@example.com&documentName=TestDoc'
response = RestClient.put(url, "", {:Password => "sfhdf6df5fdy"})
puts response						
						

import requests

url = "http://www.example.com/api/rest/Documents/TestSend/?accountName=acme&login=ApiUser&emailAddress=joe@example.com&documentName=TestDoc";
headers = {'password':'sfhdf6df5fdy'}
resp = requests.put(url, headers=headers)
if resp.status_code == 200:
	print resp.text