Send Transactional Email

POST https://api.yonoma.io/v1/email/send

Send POST request to this end posint to send the transactional email.

Request
Body Params (application/json) Example

from_email string required

from email

to_email string required

to email

subject string required

subject

mail_template string required

mail template


{
    "from_email":"[email protected]",
    "to_email":"[email protected]",
    "subject":"Welcome to Yonoma - You're In!",
    "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }
Code Samples

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");

const raw = JSON.stringify({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }); const requestOptions = { method: "POST", headers: myHeaders, body: raw, redirect: "follow" }; fetch("https://api.yonoma.io/v1/email/send", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error));

const axios = require('axios');
let data = JSON.stringify({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://api.yonoma.io/v1/email/send', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); });

var settings = {
  "url": "https://api.yonoma.io/v1/email/send",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  "data": JSON.stringify({
    "from_email": "[email protected]",
    "to_email": "[email protected]",
    "subject": "Welcome to Yonoma - You're In!",
    "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }), }; $.ajax(settings).done(function (response) { console.log(response); });

// WARNING: For POST requests, body is set to null by browsers.
var data = JSON.stringify({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }); var xhr = new XMLHttpRequest(); xhr.addEventListener("readystatechange", function() { if(this.readyState === 4) { console.log(this.responseText); } }); xhr.open("POST", "https://api.yonoma.io/v1/email/send"); xhr.setRequestHeader("Content-Type", "application/json"); xhr.setRequestHeader("Authorization", "Bearer YOUR_API_KEY"); xhr.send(data);

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': 'api.yonoma.io',
  'path': '/v1/email/send',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }); req.write(postData); req.end();

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.yonoma.io/v1/email/send',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    "from_email": "[email protected]",
    "to_email": "[email protected]",
    "subject": "Welcome to Yonoma - You're In!",
    "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }) }; request(options, function (error, response) { if (error) throw new Error(error); console.log(response.body); });

var unirest = require('unirest');
var req = unirest('POST', 'https://api.yonoma.io/v1/email/send')
  .headers({
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  })
  .send(JSON.stringify({
    "from_email": "[email protected]",
    "to_email": "[email protected]",
    "subject": "Welcome to Yonoma - You're In!",
    "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" })) .end(function (res) { if (res.error) throw new Error(res.error); console.log(res.raw_body); });
Copy

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"from_email\":\"[email protected]\",\r\n    \"to_email\":\"[email protected]\",\r\n    \"subject\":\"Welcome to Yonoma - You're In!\",\r\n    \"mail_template\": \"

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

\"\r\n}"); Request request = new Request.Builder() .url("https://api.yonoma.io/v1/email/send") .method("POST", body) .addHeader("Content-Type", "application/json") .addHeader("Authorization", "Bearer YOUR_API_KEY") .build(); Response response = client.newCall(request).execute();

Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://api.yonoma.io/v1/email/send")
  .header("Content-Type", "application/json")
  .header("Authorization", "Bearer YOUR_API_KEY")
  .body("{\r\n    \"from_email\":\"[email protected]\",\r\n    \"to_email\":\"[email protected]\",\r\n    \"subject\":\"Welcome to Yonoma - You're In!\",\r\n    \"mail_template\": \"

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

\"\r\n}") .asString();

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.yonoma.io/v1/email/send"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "from_email":"[email protected]",`+"
"+`
    "to_email":"[email protected]",`+"
"+`
    "subject":"Welcome to Yonoma - You're In!",`+"
"+`
    "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

"`+" "+` }`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("Content-Type", "application/json") req.Header.Add("Authorization", "Bearer YOUR_API_KEY") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) }

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.yonoma.io/v1/email/send',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "from_email":"[email protected]",
    "to_email":"[email protected]",
    "subject":"Welcome to Yonoma - You\'re In!",
    "mail_template": "

We\'re excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY' ), )); $response = curl_exec($curl); curl_close($curl); echo $response;

$client = new Client();
$headers = [
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer YOUR_API_KEY'
];
$body = '{
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We\'re excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }'; $request = new Request('POST', 'https://api.yonoma.io/v1/email/send', $headers, $body); $res = $client->sendAsync($request)->wait(); echo $res->getBody();

import http.client
import json

conn = http.client.HTTPSConnection("api.yonoma.io")
payload = json.dumps({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }) headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY' } conn.request("POST", "/v1/email/send", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))

import requests
import json

url = "https://api.yonoma.io/v1/email/send"

payload = json.dumps({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }) headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://api.yonoma.io/v1/email/send")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer YOUR_API_KEY"
request.body = JSON.dump({
  "from_email": "[email protected]",
  "to_email": "[email protected]",
  "subject": "Welcome to Yonoma - You're In!",
  "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" }) response = https.request(request) puts response.read_body
Responses
HTTP Code : 200 Content Type : JSON
Data Schema Example

statusCode string required

HTTP status code

status string required

Success status

message string required

Description of the success message

data object required

from_email string

from email

to_email string

to email

subject string

subject

mail_template string

mail template


{
    "statusCode":200,
    "status": "Success",
    "message": "Transactional Email sent successfully",
    "data": {
        "from_emai": "[email protected]",
        "to_email": "[email protected]",
        "subject": "Welcome to Yonoma - You're In!",
        "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" } }
HTTP Code : 400 Content Type : JSON
Data Schema Example

statusCode string required

HTTP status code

status string required

Error status

message string required

Description of the error message

data object required

from_email string

from email

to_email string

to email

subject string

subject

mail_template string

mail template


{
    "statusCode": 400,
    "status": "Error",
    "message": "from_email is required",
    "data": {
        "from_emai": "[email protected]",
        "to_email": "[email protected]",
        "subject": "Welcome to Yonoma - You're In!",
        "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" } }
HTTP Code : 401 Content Type : JSON
Data Schema Example

statusCode string required

HTTP status code

status string required

Error status

message string required

Description of the error message

data object required

from_email string

from email

to_email string

to email

subject string

subject

mail_template string

mail template


{
    "statusCode": 401,
    "status": "Error",
    "message": "Please send valid apikey in header!",
    "data": {
        "from_email": "[email protected]",
        "to_email": "[email protected]",
        "subject": "Welcome to Yonoma - You're In!",
        "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" } }
HTTP Code : 500 Content Type : JSON
Data Schema Example

statusCode string required

HTTP status code

status string required

Error status

message string required

Description of the error message

data object required

from_email string

from email

to_email string

to email

subject string

subject

mail_template string

mail template


{
    "statusCode": 500,
    "status": "Error",
    "message": "Sorry! Something went wrong.",
    "data": {
    "from_email":"[email protected]",
    "to_email":"[email protected]",
    "subject":"Welcome to Yonoma - You're In!",
    "mail_template": "

We're excited to welcome you to Yonoma! Your successful signup marks the beginning of what we hope will be an exceptional journey.

" } }
Too many requests hit the API too quickly.