SMTP relay

From: "Acme Support" <you@yourdomain.com>
To: alex@example.com
Subject: (replaced by the template subject)
X-Wemail-Template: tpl_9f2c41d8a7b3e650
X-Wemail-Variables: {"name":"Stelios","order_id":"2940"}

This body is used only where the template has no content.

# curl speaks SMTP too (or use swaks / your mail library).
# message.eml starts with your headers — a From display name is honored:
#   From: "Acme Support" <you@yourdomain.com>
#   To: alex@example.com
#   Subject: Welcome to Acme
curl --ssl-reqd --url 'smtp://smtp.wemail.io:587' \
  --user 'you@yourdomain.com:afn_live_pK7…b9aF' \
  --mail-from 'you@yourdomain.com' \
  --mail-rcpt 'alex@example.com' \
  --upload-file message.eml

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "smtp.wemail.io",
  port: 587,               // 465 for TLS, 2525 fallback
  auth: {
    user: "you@yourdomain.com",          // a verified sender domain
    pass: process.env.WEMAIL_API_KEY,     // full_access or send_only key
  },
});

await transport.sendMail({
  from: '"Acme Support" <you@yourdomain.com>',  // display name shown to recipients
  to: "alex@example.com",
  cc: "ops@yourdomain.com",             // cc/bcc delivered + tracked per recipient
  replyTo: "support@yourdomain.com",
  subject: "Welcome to Acme",
  html: "<h1>Hi Alex</h1>",
  text: "Hi Alex",                       // plain-text alternative
  attachments: [{ filename: "invoice.pdf", path: "./invoice.pdf" }],
  headers: {
    "X-Wemail-Tag": "welcome, onboarding",                    // tags — filter events/analytics
    "X-Wemail-Variables": JSON.stringify({ order_id: "42" }),  // echoed in webhooks
    "X-Reference-Id": "order-42",       // any X-* header — echoed in webhooks
  },
});

import os, smtplib
from email.mime.text import MIMEText

msg = MIMEText("<h1>Hi Alex</h1>", "html")
msg["From"] = "Acme Support <you@yourdomain.com>"  # display name shown to recipients
msg["To"] = "alex@example.com"
msg["Subject"] = "Welcome to Acme"
msg["X-Wemail-Tag"] = "welcome, onboarding"      # tags — filter events/analytics
msg["X-Wemail-Variables"] = '{"order_id": "42"}'  # echoed in webhooks
msg["X-Reference-Id"] = "order-42"                # any X-* header — echoed in webhooks

with smtplib.SMTP("smtp.wemail.io", 587) as s:
    s.starttls()
    s.login("you@yourdomain.com", os.environ["WEMAIL_API_KEY"])
    s.send_message(msg)

<?php
// PHPMailer over the wemail SMTP relay
$mail = new PHPMailer\PHPMailer\PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.wemail.io';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = 'you@yourdomain.com';
$mail->Password = getenv('WEMAIL_API_KEY');
$mail->setFrom('you@yourdomain.com', 'Acme Support');  // display name shown to recipients
$mail->addAddress('alex@example.com');
$mail->Subject = 'Welcome to Acme';
$mail->isHTML(true);
$mail->Body = '<h1>Hi Alex</h1>';
$mail->send();

require "mail"
Mail.defaults do
  delivery_method :smtp,
    address: "smtp.wemail.io", port: 587,
    user_name: "you@yourdomain.com",
    password: ENV["WEMAIL_API_KEY"],
    enable_starttls_auto: true
end

Mail.deliver do
  from    "Acme Support <you@yourdomain.com>"
  to      "alex@example.com"
  subject "Welcome to Acme"
  html_part { content_type "text/html"; body "<h1>Hi Alex</h1>" }
end

import "net/smtp"

auth := smtp.PlainAuth("", "you@yourdomain.com", os.Getenv("WEMAIL_API_KEY"), "smtp.wemail.io")
msg := []byte("From: \"Acme Support\" <you@yourdomain.com>\r\n" +
    "To: alex@example.com\r\n" +
    "Subject: Welcome to Acme\r\n" +
    "Content-Type: text/html\r\n\r\n" +
    "<h1>Hi Alex</h1>\r\n")
smtp.SendMail("smtp.wemail.io:587", auth, "you@yourdomain.com", []string{"alex@example.com"}, msg)

Properties props = new Properties();
props.put("mail.smtp.host", "smtp.wemail.io");
props.put("mail.smtp.port", "587");
props.put("mail.smtp.auth", "true");
props.put("mail.smtp.starttls.enable", "true");

Session session = Session.getInstance(props, new Authenticator() {
  protected PasswordAuthentication getPasswordAuthentication() {
    return new PasswordAuthentication("you@yourdomain.com", System.getenv("WEMAIL_API_KEY"));
  }
});
MimeMessage m = new MimeMessage(session);
m.setFrom(new InternetAddress("you@yourdomain.com", "Acme Support")); // display name shown to recipients
m.addRecipients(Message.RecipientType.TO, "alex@example.com");
m.setSubject("Welcome to Acme");
m.setContent("<h1>Hi Alex</h1>", "text/html");
Transport.send(m);

using System.Net;
using System.Net.Mail;

var client = new SmtpClient("smtp.wemail.io", 587) {
  EnableSsl = true,
  Credentials = new NetworkCredential(
    "you@yourdomain.com",
    Environment.GetEnvironmentVariable("WEMAIL_API_KEY")),
};
var mail = new MailMessage(
    new MailAddress("you@yourdomain.com", "Acme Support"), // display name shown to recipients
    new MailAddress("alex@example.com")) {
  Subject = "Welcome to Acme",
  Body = "<h1>Hi Alex</h1>",
  IsBodyHtml = true,
};
client.Send(mail);