SMTP

Se o seu software consegue enviar e-mails por SMTP, ele pode usar o SpacePost sem escrever código.

Configuração	Valor
Host	smtp.spacepost.dev
Porta	25976
Segurança	STARTTLS (obrigatório)
Usuário	spacepost
Senha	Sua chave de API (sp_live_...)

O endereço From deve pertencer a um domínio verificado. O TLS implícito (porta 465) ainda não é oferecido.

Nodemailer

import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "smtp.spacepost.dev",
  port: 25976,
  secure: false, // STARTTLS: the connection is upgraded to TLS before login
  requireTLS: true,
  auth: { user: "spacepost", pass: process.env.SPACEPOST_API_KEY },
});

await transport.sendMail({
  from: "Acme <hello@acme.com>",
  to: "user@example.com",
  subject: "Hello over SMTP",
  html: "<p>It works.</p>",
  headers: { "X-SpacePost-Tags": "category=welcome" },
});

Python

import os, smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "user@example.com"
msg["Subject"] = "Hello over SMTP"
msg.set_content("It works.")

with smtplib.SMTP("smtp.spacepost.dev", 25976) as s:
    s.starttls()
    s.login("spacepost", os.environ["SPACEPOST_API_KEY"])
    s.send_message(msg)

swaks

swaks --server smtp.spacepost.dev --port 25976 --tls \
  --auth-user spacepost --auth-password "$SPACEPOST_API_KEY" \
  --from hello@acme.com --to delivered@test.spacepost.dev \
  --header "Subject: Hello over SMTP" --body "It works."

Referência do relay SMTPCabeçalhos, limites, códigos de erro e guias por framework.