トランザクションメールアプリのためのメールAPI
アプリが頼れるトランザクションメール。
領収書、パスワードリセット、サインインコードを、独自ドメインからAPI 1回で。
1回の呼び出しで送信
テンプレートでも独自のHTMLでも。IDがすぐに返り、イベントはWebhookで届きます。
send-receipt.tsPOST /v1/emails
const res = await fetch("https://api.mysendbox.com/v1/emails", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MYSENDBOX_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `receipt-${order.id}`,
},
body: JSON.stringify({
from: "Acme <billing@acme.example>",
to: [order.email],
template: {
id: "receipt",
variables: { name: order.name, total: order.total },
},
}),
});
const { id } = await res.json(); // "em_01m61…", 202 Accepted
すべてのエンドポイントとフィールドはAPIリファレンスに掲載しています。
認証済みの独自ドメイン
DKIMで署名し、DMARCに準拠させ、数時間ごとにチェックします。
変数付きテンプレート
バージョン管理、{{variables}}、ライブプレビュー、テスト送信に対応。
安全に再試行、予約送信も可能
Idempotency-Keyがあれば二重送信されません。72時間先まで予約送信できます。
すべてのイベントをアプリで
送信、配信、バウンス、スパム報告の署名付きWebhookと、検索可能なログ。
Webhookイベント
email.sent em_01m61… billing@acme.example → jane@example.com
email.delivered em_01m61… 250 OK
email.bounced em_01m62… 550 5.1.1 user unknown · address suppressed
email.complained em_01m63… marked as spam · address suppressed
email.failed em_01m64… not sent
バウンスは自動で処理
バウンス、苦情、配信停止は自動で抑止されます。追加のコードは不要です。
なじみのある形式
- 最大100件のバッチ。
- 最大10 MBの添付ファイル。
- Resend形式のフィールド名。
用途
顧客の操作で送られるメール、または顧客が待っているメール。ニュースレターやプロモーションには使えません(利用規定)。