Transactional email API. One request, every recipient.

curl -X POST "https://api.tinyemail.com/v1/relay/email/campaign" \
  -H "X-RELAY-ACCESS-TOKEN: $TINYRELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Reset your password",
    "body": "<p>Hi [FIRST_NAME], use this link to reset your password.</p>",
    "sender": { "from": { "name": "Acme", "email": "no-reply@acme.com" } },
    "metadata": { "user_id": "u_1042" },
    "recipients": { "to": [
      { "email": "ann@example.com", "attributes": { "FIRST_NAME": "Ann" } }
    ] }
  }'

const res = await fetch("https://api.tinyemail.com/v1/relay/email/campaign", {
  method: "POST",
  headers: {
    "X-RELAY-ACCESS-TOKEN": process.env.TINYRELAY_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    subject: "Reset your password",
    body: "<p>Hi [FIRST_NAME], use this link to reset your password.</p>",
    sender: { from: { name: "Acme", email: "no-reply@acme.com" } },
    metadata: { user_id: "u_1042" },
    recipients: { to: [{ email: "ann@example.com", attributes: { FIRST_NAME: "Ann" } }] },
  }),
});
const { requestId } = await res.json(); // 202

import os, requests

res = requests.post(
    "https://api.tinyemail.com/v1/relay/email/campaign",
    headers={"X-RELAY-ACCESS-TOKEN": os.environ["TINYRELAY_KEY"]},
    json={
        "subject": "Reset your password",
        "body": "<p>Hi [FIRST_NAME], use this link to reset your password.</p>",
        "sender": {"from": {"name": "Acme", "email": "no-reply@acme.com"}},
        "metadata": {"user_id": "u_1042"},
        "recipients": {"to": [{"email": "ann@example.com", "attributes": {"FIRST_NAME": "Ann"}}]},
    },
    timeout=10,
)
print(res.status_code, res.json()["requestId"])  # 202

<?php
$payload = json_encode([
  'subject'    => 'Reset your password',
  'body'       => '<p>Hi [FIRST_NAME], use this link to reset your password.</p>',
  'sender'     => ['from' => ['name' => 'Acme', 'email' => 'no-reply@acme.com']],
  'metadata'   => ['user_id' => 'u_1042'],
  'recipients' => ['to' => [['email' => 'ann@example.com', 'attributes' => ['FIRST_NAME' => 'Ann']]]],
]);

$ch = curl_init('https://api.tinyemail.com/v1/relay/email/campaign');
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'X-RELAY-ACCESS-TOKEN: ' . getenv('TINYRELAY_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS     => $payload,
]);
$response = curl_exec($ch); // 202: {"requestId": "...", "message": "SUCCESS"}
curl_close($ch);

package main

import (
	"bytes"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "subject": "Reset your password",
	  "body": "<p>Hi [FIRST_NAME], use this link to reset your password.</p>",
	  "sender": {"from": {"name": "Acme", "email": "no-reply@acme.com"}},
	  "metadata": {"user_id": "u_1042"},
	  "recipients": {"to": [{"email": "ann@example.com", "attributes": {"FIRST_NAME": "Ann"}}]}
	}`)
	req, _ := http.NewRequest("POST", "https://api.tinyemail.com/v1/relay/email/campaign", bytes.NewReader(body))
	req.Header.Set("X-RELAY-ACCESS-TOKEN", os.Getenv("TINYRELAY_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close() // expect 202 Accepted
}

require "net/http"
require "json"

uri = URI("https://api.tinyemail.com/v1/relay/email/campaign")
req = Net::HTTP::Post.new(uri)
req["X-RELAY-ACCESS-TOKEN"] = ENV.fetch("TINYRELAY_KEY")
req["Content-Type"] = "application/json"
req.body = {
  subject: "Reset your password",
  body: "<p>Hi [FIRST_NAME], use this link to reset your password.</p>",
  sender: { from: { name: "Acme", email: "no-reply@acme.com" } },
  metadata: { user_id: "u_1042" },
  recipients: { to: [{ email: "ann@example.com", attributes: { FIRST_NAME: "Ann" } }] }
}.to_json

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts res.code # 202