Transactional API


1. Setup your account

Send Mail


POST Content-Type : application/x-www-form-urlencoded


1. api: The api key of your account.

2. username: The username of your account.

3. from: Specify a Sender email address.

4. to : Specify a Recipient email address.

5. subject : The subject of your email

6. message : The HTML content of your email message.

API Results

1. status: success|fail

2. message: Send|Queued

3. id: Message id of emails.

4. error: (if status was fail) describes why the query failed,
- Request method is not correct.
- Required parameter missing or invalid.
- User authentication failed. Wrong API Key or username.
- Domain authentication failed. Unverified Sender found.
- The request was refused due to insufficent credit.

Sample Codes

curl -X POST
-d "username=your_username
&subject=This is a test email
&message=Hi, this is my first test mail"
import requests
payload = {'username': 'your_username',
'api': 'your_api_key',
'to': '',
'from': '',
'subject': 'This is a test email',
'message': 'Hi, this is my first test mail'}
print response.text
var http = require("http");
const postData = "username=your_username
&subject=This is a test email
&message=Hi, this is my first test mail"
var options = {
"method": "POST",
"hostname": "",
"port": null,
"path": "/api/v1/mail/send/",
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
var req = http.request(options, function (res) {
res.on("data", function (chunk) {
res.on("end", function () {
}); });
require 'uri'
require 'net/http'
url = URI("")
http =, url.port)
request =
request["Content-Type"] = "application/x-www-form-urlencoded"
request.set_form_data({"username" => "your_username",
"api" => "your_api_key",
"to" => "", "from" => "",
"subject" => "This is a test email",
"message" => "Hi, this is my first test mail"})
response = http.request(request)
puts response.read_body
var client = new RestClient("");
var request = new RestRequest("mail/send/", Method.POST);
request.AddParameter("username", "your_username");
request.AddParameter("api", "your_api_key");
request.AddParameter("from", "");
request.AddParameter("to", "");
request.AddParameter("subject", "This is a test email");
request.AddParameter("message", "Hi, this is my first test mail");
var httpResponse = client.Execute(request);
string json = httpResponse.Content.ToString();
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, '');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "username=your_username&api=your_api_key
&subject=This is a test email
&message=Hi, this is my first test mail");
curl_setopt($ch, CURLOPT_POST, 1);
$headers = array();
$headers[] = 'Content-Type: application/x-www-form-urlencoded';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$head = curl_exec($ch);
echo $head;