Email Testing for Developers

# create an inbox
curl -X POST https://api.smtp.dev/accounts \
  -H "X-API-KEY: $SMTP_DEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "qa@example.com", "password": "use-a-secret"}'

# your app sends to it, then read what arrived
curl "https://api.smtp.dev/accounts/$ACCOUNT/mailboxes/$INBOX/messages" \
  -H "X-API-KEY: $SMTP_DEV_API_KEY"

const transport = nodemailer.createTransport({
  host: 'send.smtp.dev',
  port: 587,
  requireTLS: true,
  auth: { user: 'ci@example.com', pass: process.env.SMTP_DEV_PASSWORD },
})

await transport.sendMail({
  from: 'ci@example.com',
  to: 'qa@example.com',
  subject: `Welcome ${Date.now()}`,
  text: 'Confirm your address: https://example.com/confirm/abc123',
})

// read it back over the API, newest first
const { member } = await fetch(
  `https://api.smtp.dev/accounts/${account}/mailboxes/${inbox}/messages`,
  { headers: { 'X-API-KEY': process.env.SMTP_DEV_API_KEY } },
).then(res => res.json())

assert.match(member[0].text, /\/confirm\//)

msg = EmailMessage()
msg["From"], msg["To"] = "ci@example.com", "qa@example.com"
msg["Subject"] = "Reset your password"
msg.set_content("https://example.com/reset/abc123")

with smtplib.SMTP("send.smtp.dev", 587) as smtp:
    smtp.starttls()
    smtp.login("ci@example.com", os.environ["SMTP_DEV_PASSWORD"])
    smtp.send_message(msg)

# read it back over the API, newest first
messages = requests.get(
    f"https://api.smtp.dev/accounts/{account}/mailboxes/{inbox}/messages",
    headers={"X-API-KEY": os.environ["SMTP_DEV_API_KEY"]},
).json()["member"]