Your email campaigns, written, sent and delivered

With requests, the most common HTTP library.

import requests

BASE = 'https://app.sparrowmessage.com/api/v1'
HEADERS = {'Accept': 'application/json', 'Content-Type': 'application/json'}

# ── Authentication
auth = requests.post(f'{BASE}/login', headers=HEADERS, json={
    'email': 'you@company.com',
    'password': 'your-password',
}).json()

if auth.get('code') != 'OK':
    raise RuntimeError(auth.get('error', 'Authentication failed'))

token = auth['user']['api_token']
headers = {**HEADERS, 'Authorization': f'Bearer {token}'}

# ── Single send
msg = requests.post(f'{BASE}/mail/send/one', headers=headers, json={
    'email': 'client@exemple.com',
    'subject': 'Your order #4521 is confirmed',
    'html':  '<p>Thank you for your order.</p>',
}).json()
print(msg['message_id'])

# ── Bulk send
masse = requests.post(f'{BASE}/mail/send/bulk', headers=headers, json={
    'emails': ['client1@exemple.com', 'client2@exemple.com'],
    'subject':  'This month's offers',
    'html':   '<h1>What's new</h1><p>Discover the selection.</p>',
}).json()
print(masse['message_ids'], masse.get('mails_error'))

fetch is built in from Node 18 onwards.

const BASE = 'https://app.sparrowmessage.com/api/v1';
const JSON_HEADERS = { 'Accept': 'application/json', 'Content-Type': 'application/json' };

// ── Authentication
const auth = await (await fetch(`${BASE}/login`, {
  method: 'POST',
  headers: JSON_HEADERS,
  body: JSON.stringify({ email: 'you@company.com', password: 'your-password' })
})).json();

if (auth.code !== 'OK') throw new Error(auth.error || 'Authentication failed');

const headers = { ...JSON_HEADERS, Authorization: `Bearer ${auth.user.api_token}` };

// ── Single send
const msg = await (await fetch(`${BASE}/mail/send/one`, {
  method: 'POST',
  headers: headers,
  body: JSON.stringify({
    email: 'client@exemple.com',
    subject: 'Your order #4521 is confirmed',
    html:  '<p>Thank you for your order.</p>'
  })
})).json();

// ── Bulk send
const masse = await (await fetch(`${BASE}/mail/send/bulk`, {
  method: 'POST',
  headers: headers,
  body: JSON.stringify({
    emails: ['client1@exemple.com', 'client2@exemple.com'],
    subject:  'This month's offers',
    html:   '<h1>What's new</h1><p>Discover the selection.</p>'
  })
})).json();

HttpClient, with no external dependency.

using System.Net.Http.Json;

const string Base = "https://app.sparrowmessage.com/api/v1";
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Accept", "application/json");

// ── Authentication
var auth = await (await http.PostAsJsonAsync($"{Base}/login", new {
    email    = "you@company.com",
    password = "your-password"
})).Content.ReadFromJsonAsync<JsonElement>();

if (auth.GetProperty("code").GetString() != "OK")
    throw new Exception(auth.GetProperty("error").GetString());

var token = auth.GetProperty("user").GetProperty("api_token").GetString();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

// ── Single send
var msg = await http.PostAsJsonAsync($"{Base}/mail/send/one", new {
    email = "client@exemple.com",
    subject = "Your order #4521 is confirmed",
    html  = "<p>Thank you for your order.</p>"
});

// ── Bulk send
var masse = await http.PostAsJsonAsync($"{Base}/mail/send/bulk", new {
    emails = new[] { "client1@exemple.com", "client2@exemple.com" },
    sujet  = "This month's offers",
    html   = "<h1>What's new</h1><p>Discover the selection.</p>"
});

java.net.http, included since Java 11.

String base = "https://app.sparrowmessage.com/api/v1";
HttpClient client = HttpClient.newHttpClient();

// ── Authentication
HttpRequest login = HttpRequest.newBuilder(URI.create(base + "/login"))
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"email":"you@company.com","password":"your-password"}"""))
    .build();

String reponse = client.send(login, HttpResponse.BodyHandlers.ofString()).body();
String token   = new JSONObject(reponse).getJSONObject("user").getString("api_token");

// ── Single send
HttpRequest msg = HttpRequest.newBuilder(URI.create(base + "/mail/send/one"))
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer " + token)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {
          "email": "client@exemple.com",
          "subject": "Your order #4521 is confirmed",
          "html":  "<p>Thank you for your order.</p>"
        }"""))
    .build();

client.send(msg, HttpResponse.BodyHandlers.ofString());

// ── Bulk send: "emails" is an array
HttpRequest masse = HttpRequest.newBuilder(URI.create(base + "/mail/send/bulk"))
    .header("Accept", "application/json")
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer " + token)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {
          "emails": ["client1@exemple.com", "client2@exemple.com"],
          "subject":  "This month's offers",
          "html":   "<h1>What's new</h1>"
        }"""))
    .build();

client.send(masse, HttpResponse.BodyHandlers.ofString());

To try it from a terminal, before writing a single line.

# ── 1. Get the token
curl -X POST https://app.sparrowmessage.com/api/v1/login \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@company.com","password":"your-password"}'

# Response:
# { "code":"OK", "token":"…", "user":{ "api_token":"…" } }

# ── 2. Send an email
curl -X POST https://app.sparrowmessage.com/api/v1/mail/send/one \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_API_TOKEN" \
  -d '{
        "email": "client@exemple.com",
        "subject": "Your order #4521 is confirmed",
        "html":  "<p>Thank you for your order.</p>"
      }'

# ── 3. Send to several recipients
curl -X POST https://app.sparrowmessage.com/api/v1/mail/send/bulk \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_API_TOKEN" \
  -d '{
        "emails": ["client1@exemple.com", "client2@exemple.com"],
        "subject":  "This month's offers",
        "html":   "<h1>What's new</h1><p>Discover the selection.</p>"
      }'

If your application already sends email, there is nothing to code: just change the outgoing server settings.

Server      : smtp.sparrowmessage.com
Port        : 587 (STARTTLS)  ·  465 (SSL/TLS)  ·  2525 (fallback)
Security    : TLS required
Username    : provided when the account is opened
Password    : provided when the account is opened
Sender      : an address on your authenticated domain

# ── PHP example, using PHPMailer
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.sparrowmessage.com';
$mail->SMTPAuth   = true;
$mail->Username   = 'your-username';
$mail->Password   = 'your-key';
$mail->SMTPSecure = 'tls';
$mail->Port       = 587;
$mail->setFrom('facture@yourcompany.com', 'Your Company');
$mail->addAddress('client@exemple.com');
$mail->Subject = 'Your order #4521 is confirmed';
$mail->isHTML(true);
$mail->Body    = '<p>Thank you for your order.</p>';
$mail->send();

# ── Python example, no dependencies
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg['From']    = 'facture@yourcompany.com'
msg['To']      = 'client@exemple.com'
msg['Subject'] = 'Your order #4521 is confirmed'
msg.set_content('Thank you for your order.')

with smtplib.SMTP('smtp.sparrowmessage.com', 587) as s:
    s.starttls()
    s.login('your-username', 'your-key')
    s.send_message(msg)