Email API for Developers

                                        // Send an email with the UniOne Email API PHP Library
// Learn more -> https://docs.unione.io/en/integrations
// First install with composer: composer require unione/unione-php
require 'vendor/autoload.php';

// Use eu1.unione.io for EU or us1.unione.io for US account
$client = new Unione\UnioneClient('YOUR-API-KEY', 'eu1.unione.io');
$recipients = [
    [
        "email" => 'john@example.com',
        "substitutions" => ["to_name" => 'John Smith']
    ]
];
$body = ["html" => "Hello, {{to_name}}!"];
$mail = new Unione\Model\Email($recipients, $body);
$mail->setFromEmail('user@example.com');
$mail->setSubject('Hello from UniOne');
$response = $client->emails()->send($mail->toArray());
if ($response['status'] == 'success') {
  echo 'Success, job_id='.$response['job_id']."\n";
}

                                        

                                        # Send an email with the UniOne Email API Ruby gem
# Learn more -> https://docs.unione.io/en/integrations 
# First install the UniOne Ruby gem: gem install unione-ruby

require 'unione-ruby'
require 'json'

# Use eu1.unione.io for EU or us1.unione.io for US account
unione = UniOne::Client.new(
    hostname: 'eu1.unione.io', api_key: 'YOUR-API-KEY')

message = {}
message[:recipients] = []
message[:recipients] << {
    email: 'john@example.com',
    substitutions: { to_name: 'John Smith' }
}
message[:body] = { html: "Hello, {{to_name}}!" }
message[:from_email]  = 'user@example.com'
message[:subject]  = 'Hello from UniOne'

response = unione.send_email(message: message)

if response.success? && response.to_hash[:body][:status]=='success'
    puts "Success, job_id=" + response.to_hash[:body][:job_id]
end

                                        

                                        # Send an email with the UniOne Web API
# Learn more -> https://docs.unione.io/en/web-api-ref#web-api 
# First install the requests module: pip install requests
import requests

# Use eu1.unione.io for EU or us1.unione.io for US account
base_url = 'https://eu1.unione.io/en/transactional/api/v1'
headers = {
  'Content-Type': 'application/json',
  'X-API-KEY': 'YOUR-API-KEY'
}

request_body = {
    "message": {
        "recipients": [
            {
                "email": "john@example.com",
                "substitutions": { "to_name": "John Smith" }
            }
        ],
        "body": {
            "html": "Hello, {{to_name}}!"
        },
        "subject": "Hello from UniOne",
        "from_email": "user@example.com"
    }
}
response = requests.post(base_url+'/email/send.json',
json=request_body, headers=headers)

if response.ok and response.json()["status"] == 'success':
    print("Success, job_id=" + response.json()["job_id"])

                                        

                                        // Send an email with the UniOne Email API C# library
// Learn how to set up UniOne C# library:
// https://github.com/unione-repo/unione-csharp

using System.Text;
using Microsoft.Extensions.Configuration;
using UniOne.Models;

// Use eu1.unione.io for EU or us1.unione.io for US account
var json = "{\"UniOne\":{" +
    "\"ServerAddress\":\"https://eu1.unione.io/\"," +
    "\"X-API-KEY\":\"YOUR-API-KEY\"}}";

IConfiguration configuration = new ConfigurationBuilder()
    .AddJsonStream(new MemoryStream(Encoding.ASCII.GetBytes(json)))
    .Build();

var uniOne = new UniOne.UniOne(configuration);
var msg = new EmailMessageData {
    FromEmail = "user@example.com",
    Recipients = new List<EmailRecipientData> {
        new EmailRecipientData {
            EmailAddress = "john@example.com",
            Substitutions = new Dictionary<object, object> {
                {"to_name", "John Smith"}
            }
        }
    },
    Subject = "Hello from UniOne",
    Body = new Body { Html = "Hello, {{to_name}}!" }
};

var email = await uniOne.Email.Send(msg);
if (email != null) {
    Console.WriteLine("Success, job_id=" + email.JobId);
} else {
    Console.WriteLine(uniOne.Email.GetError()!.Details!.Message);
}
                                        

                                        // Send an email with the UniOne Web API
// Learn more -> https://docs.unione.io/en/web-api-ref#web-api 
// First install node-fetch module: npm install node-fetch
import fetch from "node-fetch"

// Use eu1.unione.io for EU or us1.unione.io for US account
const base_url = 'https://eu1.unione.io/en/transactional/api/v1'
const headers = {
    'Content-Type':'application/json',
    'X-API-KEY':'YOUR-API-KEY'
};

const request = JSON.stringify({
    message: {
        recipients: [{
            email: 'john@example.com',
            substitutions: { to_name: 'John Smith' },
        }],
        body: { html: 'Hello, {{to_name}}!' },
        subject: 'Hello from UniOne',
        from_email: 'user@example.com',
    },
});
fetch(base_url + '/email/send.json', {
    method: 'POST',
    body: request,
    headers: headers
})
.then((response) => response.json())
.then(data => {
    if(data.status == "success") {
        console.log("Success, job_id=" + data.job_id);
    }
});

                                        

                                        # Send an email with the UniOne Web API
# Learn more -> https://docs.unione.io/en/web-api-ref#web-api 

# Use eu1.unione.io for EU or us1.unione.io for US account
curl -X POST \
  https://eu1.unione.io/en/transactional/api/v1/email/send.json \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR-API-KEY' \
  -d '{
  "message": {
    "recipients": [
      {
        "email": "john@example.com",
        "substitutions": {
          "to_name": "John Smith"
        }
      }
    ],
    "body": {
      "html": "Hello, {{to_name}}!"
    },
    "subject": "Hello from UniOne",
    "from_email": "user@example.com"
  }
}