REST Email Marketing API Documentation

DOCUMENTS — QUEUE

Send a document to a recipient. The recipient must have been added to the database previously.

HTTP VERB

Put

URL

/API/Rest/Documents/Queue

ARGUMENTS

documentName
emailAddress

Required permission

QueueDocument

ERRORS

No Permission
Email address is not a known recipient
Invalid document name
Recipient is on hold because of an invalid email address
Recipient is on the global unsubscribe list.
Recipient is suppressed for this topic
Recipient is on the global suppression list
Recipient is unsubscribed from this topic
Recipient has not responded to a confirmation request
Database error
Unknown error

RETURNS

Success

EXAMPLE

Queue a document to be sent to a recipient.

using System;
using System.Net.Http;

string url = "https://example.com/API/Rest/Documents/Queue?accountName=acme&login=ApiUser&documentName=TestDoc&emailAddress=joe@example.com";

// Reuse HttpClient for multiple requests in production code.
using (var client = new HttpClient())
using (var request = new HttpRequestMessage(HttpMethod.Put, url))
{
	request.Headers.Add("Password", "YOUR_PASSWORD");

	using (HttpResponseMessage response = await client.SendAsync(request))
	{
		response.EnsureSuccessStatusCode();
		Console.WriteLine(await response.Content.ReadAsStringAsync());
	}
}

# encoding: utf-8
require 'rest-client'
require 'json'

url = 'https://example.com/API/Rest/Documents/Queue?accountName=acme&login=ApiUser&documentName=TestDoc&emailAddress=joe@example.com'
response = RestClient.put(url, "", {:Password => "YOUR_PASSWORD"})
puts response

import requests

url = "https://example.com/API/Rest/Documents/Queue?accountName=Acme&login=ApiUser&emailAddress=dave@aol.com&documentName=TestDoc"
headers = {'password':'YOUR_PASSWORD'}
resp = requests.put(url, headers=headers)
if resp.status_code == 200:
	print(resp.text)

curl --request PUT --header "Password: YOUR_PASSWORD" "https://example.com/API/Rest/Documents/Queue?accountName=acme&login=ApiUser&documentName=TestDoc&emailAddress=joe@example.com"