任意の SMTP 対応言語またはクライアントから、Cloudflare Email Service の 認証済み SMTP(smtp.mx.cloudflare.net:465)でトランザクションメールを送信します。
- Email Sending 用にオンボード済みのドメイン。
- Email Sending: Edit 権限を持つ Cloudflare API トークン。環境変数に
CF_API_TOKENとして設定します。トークンは SMTP パスワードとして使い、ユーザー名は文字列api_tokenです。
cat > mail.txt <<EOF
From: welcome@yourdomain.com
To: recipient@example.com
Subject: Welcome to our service!
Thanks for signing up.
EOF
curl --ssl-reqd \
--url "smtps://smtp.mx.cloudflare.net:465" \
--user "api_token:$CF_API_TOKEN" \
--mail-from "welcome@yourdomain.com" \
--mail-rcpt "recipient@example.com" \
--upload-file mail.txt送信者ドメインは、API トークンを所有するアカウントで Email Sending 用にオンボードされている必要があります。
Nodemailer ↗ を npm install nodemailer でインストールします。
import nodemailer from "nodemailer";
const transporter = nodemailer.createTransport({
host: "smtp.mx.cloudflare.net",
port: 465,
secure: true, // implicit TLS
auth: {
user: "api_token",
pass: process.env.CF_API_TOKEN,
},
});
const info = await transporter.sendMail({
from: '"Acme" <welcome@yourdomain.com>',
to: "user@example.com",
subject: "Welcome to Acme",
text: "Thanks for signing up.",
html: "<h1>Welcome to Acme</h1><p>Thanks for signing up.</p>",
});
console.log("Message sent:", info.messageId);const info = await transporter.sendMail({
from: '"Acme Billing" <billing@yourdomain.com>',
to: "customer@example.com",
subject: "Your invoice",
text: "Please find your invoice attached.",
attachments: [
{
filename: "invoice-2026-04.pdf",
path: "./invoices/invoice-2026-04.pdf",
contentType: "application/pdf",
},
],
});メッセージ全体のサイズ(Base64 エンコードした添付ファイルを含む)は 5 MiB 以下である必要があります。制限 を参照してください。
Nodemailer は、.responseCode に SMTP 応答コードが入った Error で Promise を拒否します。SMTP 応答コード と トラブルシューティング を参照してください。
try {
await transporter.sendMail({
/* ... */
});
} catch (err) {
console.error(err.responseCode, err.message);
}標準ライブラリの smtplib ↗ を使います(Python 3.8 以降)。
import os
import smtplib
from email.message import EmailMessage
msg = EmailMessage()
msg["From"] = "Acme <welcome@yourdomain.com>"
msg["To"] = "user@example.com"
msg["Subject"] = "Welcome to Acme"
msg.set_content("Thanks for signing up.")
msg.add_alternative(
"<h1>Welcome to Acme</h1><p>Thanks for signing up.</p>",
subtype="html",
)
with smtplib.SMTP_SSL("smtp.mx.cloudflare.net", 465) as s:
s.login("api_token", os.environ["CF_API_TOKEN"])
s.send_message(msg)smtplib.SMTP_SSL はポート 465 で implicit TLS 接続を開きます。Cloudflare の SMTP エンドポイントが求める方式です。smtplib.SMTP と starttls() は使わないでください。STARTTLS はサポートされていません。
msg["To"] = ", ".join([
"user1@example.com",
"user2@example.com",
"user3@example.com",
])1 つの SMTP セッションで届けられる RCPT TO アドレスは最大 50 件です。制限 を参照してください。
from pathlib import Path
pdf = Path("invoice-2026-04.pdf").read_bytes()
msg.add_attachment(
pdf,
maintype="application",
subtype="pdf",
filename="invoice-2026-04.pdf",
)smtplib は、SMTP 応答コード付きの smtplib.SMTPException のサブクラスを送出します。SMTP 応答コード と トラブルシューティング を参照してください。
try:
with smtplib.SMTP_SSL("smtp.mx.cloudflare.net", 465) as s:
s.login("api_token", os.environ["CF_API_TOKEN"])
s.send_message(msg)
except smtplib.SMTPAuthenticationError as e:
print(f"Auth failed: {e.smtp_code} {e.smtp_error!r}")
except smtplib.SMTPResponseException as e:
print(f"SMTP error: {e.smtp_code} {e.smtp_error!r}")<?php
use PHPMailer\PHPMailer\PHPMailer;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.mx.cloudflare.net';
$mail->Port = 465;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->SMTPAuth = true;
$mail->Username = 'api_token';
$mail->Password = getenv('CF_API_TOKEN');
$mail->setFrom('welcome@yourdomain.com', 'Acme');
$mail->addAddress('recipient@example.com');
$mail->Subject = 'Welcome to our service!';
$mail->Body = 'Thanks for signing up.';
$mail->send();- SMTP リファレンス — 接続情報、認証、応答コード、トラブルシューティング。
- 受信者を指定する — 複数の受信者、CC と BCC、名前付きアドレス。
- 制限 — アカウント、メッセージ、セッションの制限。