新しいガイド:評判を損なわずに専用IPをウォームアップする方法。 続きを読む →
MigoSMTP
メールAPI

コードからメールを送信、追跡、管理

送信、テンプレート、イベント、レポートに対応したREST APIで、スコープ付きキーと分かりやすいエラーを備えています。

エージェント対応:MCPサーバーにより、AIアシスタントがメールを安全に送信・確認できます。

リクエスト
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
レスポンス
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Keyに対応
202 Accepted
JSON
べき等
1回のJSON呼び出しで送信Bearerキーで認証し、小さなJSONボディをPOSTすると、メッセージIDがすぐに返ります。
クイックスタート
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
送信済み · 202
型付きSDK
オープンソース
お使いのスタック向けの公式ライブラリNode、Python、PHP、Goから選べます。同じ数行のコードでメッセージを送信でき、エラー処理もどの言語でも同じです。
APIキーのスコープ
メールを送信許可
イベントを読み取り許可
ドメインを管理管理者のみ
レート制限[n] req/s
最小権限
安全にローテーション
必要なアクセスだけを持つキーサービスごとに1つのキーを作成して権限を制限し、他に影響を与えずに1つだけ無効化できます。
レート制限
トラフィックの急増
キューが急増を平準化
欠落なし
バックプレッシャー
データ損失なし
バーストを余裕を持って吸収トラフィックがレートを超えて急増しても、リクエストは失敗せずにキューに入って順次処理されるため、何も失われません。
メッセージイベント
署名付きイベント
/events
200 OK
データウェアハウス
200 OK
アラート
30秒後に再試行
HMAC署名
At-least-once
イベントも同じ経路で返送同じAPIで、配信、開封、クリック、バウンスのイベントが署名付きでエンドポイントにストリーミングされます。
請求書をPriyaにメールして、配信を確認して
AIエージェント
MigoSMTP MCPスコープ付きキー
send_emailメッセージを送信
get_events配信結果を読み取り
check_domainDNSレコードを検証
送信済み · リクエストIDを記録 · 配信を確認済み
MCP準備完了
スコープ付きでログも記録
AIエージェントからAPIを呼び出せます同じAPIをMCP経由でも利用できるため、エージェントがメール送信、イベント取得、DNS検証を行えます。キーはスコープ付きで、呼び出しはログに記録され、送信には承認を必須にもできます。
1回のリクエスト
SDK
スコープ付きキー
レート制限
Webhook
エージェントAPI
SMTPリレーREST APIWebhook専用IPDKIM署名インバウンドパーステンプレート分析抑止リスト評判モニタリングメール検証チームロールと監査ログSMTPリレーREST APIWebhook専用IPDKIM署名インバウンドパーステンプレート分析抑止リスト評判モニタリングメール検証チームロールと監査ログ
機能

本番環境で頼れるAPI

RESTエンドポイント

メッセージ、テンプレート、ドメイン、イベントを予測しやすいリソースで提供します。

テンプレートと変数

テンプレート名を指定して送信し、メッセージごとに変数を渡せます。

冪等性キー

重複送信なしで、安全に再試行できます。

スコープ付きAPIキー

各サービスに必要な権限だけを付与できます。

Webhook

すべての配信結果について、署名付きイベントを受け取れます。

明確なエラーと制限

一貫したエラーコードとレート制限ヘッダー。

仕組み

お客様のサービススコープ付きAPIキーを使い、HTTPSで送信エンドポイントを呼び出します。
MigoSMTPメールAPIリクエストを検証し、テンプレートと制限を適用して、メッセージをキューに入れ、IDを返します。
イベントをお客様側へ返送署名付きwebhookで、配信、バウンス、苦情の結果をアプリに通知します。
ステップ1

APIキーを作成

利用するサービスに合わせて、スコープとIP許可リストを選択します。

ステップ2

最初のメッセージを送信

検証済みの送信元と宛先を指定して、送信エンドポイントを呼び出します。

ステップ3

イベントを受信

webhookを登録して、配信、バウンス、エンゲージメントを追跡します。

実際の動作を見る

最初の送信から受信トレイまで、1つのプラットフォームで

ステージを切り替えて、各段階でコントロールできる内容を確認できます。イメージ画面です。表示されている数値とアドレスはすべてサンプルデータです。

app.migosmtp.com / sendサンプルデータ
キュー済み
184,320
本日の送信数
6,418,905
レート
412/s
受理you@example.comへのメッセージ
受理team@example.comへのメッセージ
キュー済み受信者25,000件のバッチ
受理ops@example.comへのメッセージ
開発者向け

バージョン管理され、ドキュメントも充実。テストも簡単

ダッシュボードの全機能をAPIで利用でき、お使いの言語のサンプルも用意しています。

  • IP許可リスト対応のスコープ付きキー
  • 冪等なリクエストで安全に再試行
  • 一貫したエラー形式
  • SDKとコピーしてすぐ使えるサンプル
概要
ベースURLapi.migosmtp.com/v1
認証Bearer APIキー
形式HTTPS経由のJSON
イベント署名付きwebhook
リファレンスAPIリファレンス全文とSDKサンプル
概要

メールAPIとは?

メールAPIは、SMTPを使わずにHTTPエンドポイントを呼び出して、コードからメールを送信・管理できるWebインターフェースです。MigoSMTPのメールAPIでは、検証済みの送信元、宛先、そして本文またはテンプレート名を含むJSONリクエストをPOSTすると、メッセージがキューに入り、MigoMTAインフラを通じて配信されます。レスポンスには追跡用の識別子が含まれます。生のHTTPで送信することもできます。

このAPIは、メッセージ、テンプレート、ドメイン、イベントを予測しやすいリソースとして扱いたいプロダクトチームに適しています。キーはスコープ付きなので、請求サービスは領収書を送信できても、ドメインは編集できません。冪等性キーにより再試行が安全になり、一貫したエラーコードとレート制限ヘッダーのおかげで、クライアントはきれいにバックオフできます。ダッシュボードの全機能はAPIでも利用できます。ワークスペースとキーを分けることで、サンドボックスと本番のトラフィックを分離でき、テスト送信が本番のレポートや評判に影響しません。

到達率の面でも、APIならSMTPにはない制御ができます。構造化されたエラー、メッセージごとのメタデータ、アプリケーションに戻せるイベントwebhookなどです。抑止リストの処理と組み合わせれば、不良アドレスへの送信を自動的に止められます。MCPサーバーを使えば、AIエージェントがスコープ付きで取り消し可能なキーのもとで同じAPIを呼び出せるため、自動化を設定した制限の範囲内に収められます。各キーはスコープ付きでログも記録されるので、どのサービスやエージェントがどのメッセージを送信したかを正確に把握でき、必要なら直ちにアクセスを取り消せます。

ユースケース

メールAPIの主な活用例

アプリからのトランザクションメール

API呼び出し1回で、領収書、パスワードリセット、アラートを送信できます。テンプレート名を指定して変数を渡すだけなので、プロダクトのコードにHTMLを持ち込まず、文面の変更にも影響されません。

ジョブキューでの安全な再試行

送信ごとに冪等性キーを付与します。ワーカーがクラッシュして再試行しても、メールAPIが重複を検知し、同じメッセージを二重に送信しません。

マイクロサービスごとのキー

サービスごとに、IP許可リスト付きのスコープ付きキーを1つ発行します。1つのサービスが侵害されても、取り消すのはキー1つだけで、残りのメール配信パイプラインは稼働し続けます。

イベントでループを完結

送信エンドポイントとwebhookを組み合わせれば、データベースに配信済み、バウンス、苦情の状態が反映されます。サポートチームはログを開かなくても、メールの行方を回答できます。

SaaSプロダクトからの通知

招待、利用状況のアラート、請求通知などのアプリ内イベントを1つのAPIから送信できます。サービスごとに1つのキーを使い、テンプレートはプロダクトチームが管理します。

エージェントと自動化

送信のみ、またはステータス参照のみが可能なスコープ付きキーを、AIエージェントや社内ツールに付与できます。すべての呼び出しはそのキーに紐づいてログに記録されるため、動作を確認でき、いつでも取り消せます。

方法の選択

メールAPIとSMTPリレー、どちらを選ぶ?

どちらも同じインフラを通じて配信されます。ソフトウェアの構成に合わせて選んでください。

メールAPISMTPリレー
最適な用途テンプレート、冪等性、構造化レスポンスを活用したい新規コードすでにSMTPに対応している既存アプリ、CMSプラグイン、デバイス
連携方法任意の言語からHTTPSとJSONで利用メール設定にホストと認証情報を入力
エラー構造化されたエラーコードとレート制限ヘッダーSMTPレスポンスコード
アクセス制御スコープ付きAPIキー、任意のIP許可リストアカウントごとの認証情報とIP許可リスト

1つのワークスペースで両方を併用できます。変更できないツールにはSMTP、新しいサービスにはAPIをお使いください。

AI機能

AI支援のメールAPI

エージェント対応

AIエージェント向けMCPサーバー

MCPサーバー経由でAIアシスタントをMigoSMTPに接続すると、メッセージのステータス確認や送信の下書き作成ができます。キーには付与したスコープが適用され、送信には人の承認を必須にもできます。

コパイロット

エラートリアージ用コパイロット

APIエラーや失敗したリクエストを貼り付けると、未検証の送信元や不正なフィールドなど、原因をコパイロットが説明し、修正した呼び出し例を提示します。修正はご自身で適用します。

アシスト

AIによる連携コードの下書き

送信したい内容を説明すると、アシスタントが当社のSDKの規約に沿って、お使いの言語でサンプルリクエストを生成します。本番に反映する前に、確認とテストを行ってください。

予測型

急増と不正利用の検知

異常検知がキーごとの送信レートを監視し、通常と異なる急増を検出します。チームへの通知やキーの一時停止の提案が可能で、自動での対応は、お客様が有効にした場合のみ実行されます。

AI機能は補助的で任意です。エージェントは付与されたスコープの範囲内でのみ動作し、キーと送信の管理は常にチームが握ります。

ベストプラクティス

メールAPIのベストプラクティス

すべての送信で冪等性キーを使う

注文IDとイベントの組み合わせなど、論理的なメール1通ごとに固定のキーを生成します。タイムアウト後に再試行しても、メッセージが重複することはありません。

キーのスコープは最小限に

各サービスには必要な権限だけを付与し、アドレスが固定なら、IP許可リストも追加します。影響範囲が小さいほど、インシデント対応は簡単になります。

レート制限ヘッダーを尊重する

すべてのレスポンスで制限ヘッダーを確認し、スロットリングされる前にバックオフしてください。ジッター付きの指数バックオフなら、APIに負荷をかけずにバーストを処理できます。

webhookの署名を検証する

各イベントは、信頼する前に署名を確認します。シークレットは定期的に、漏えいの恐れがあるときはすぐにローテーションしてください。

メッセージIDを保存する

送信呼び出しで返された識別子を、自社のレコードと一緒に保存します。後のサポート対応やイベントの突き合わせが簡単になります。

テストと本番を分ける

ステージングと本番では、ワークスペースとキーを分けてください。テスト時の誤りが実際の受信者に届いたり、評判に影響したりすることはありません。

よくある質問

メールAPI:よくある質問

連携でお困りですか?本番公開の前に、当社チームが一緒に確認します。

メールAPIとは?

メールAPIとは、メールサーバーを運用せずに、ソフトウェアからメールを送信・管理できるHTTPエンドポイントです。JSONリクエストを送ると、プロバイダーがメッセージをキューに入れて配信し、ステータスの更新はレスポンスとwebhookで受け取れます。

MigoSMTP APIでメールを送信するには?

APIキーを作成して送信元ドメインを検証し、送信エンドポイントに、送信元アドレス、宛先、本文または変数付きテンプレートを含むJSONをPOSTします。レスポンスには追跡可能なメッセージIDが返されます。各フィールドはAPIリファレンスをご覧ください。

メールAPIとSMTPの違いは?

SMTPは既存のソフトウェアがすでに対応しているプロトコルなので、コードの変更が不要です。APIはHTTPSとJSONを使い、構造化エラー、テンプレート、冪等性、メタデータを利用できます。どちらも同じ配信インフラを使うため、アプリケーションの構成に合わせて選んでください。

メールAPIをテストするサンドボックスはありますか?

テスト用には別のワークスペースとAPIキーを使うと、テスト送信が本番のレポートや送信者の評判に影響しません。テストと本番でキーを共有しないでください。アカウントにテストモードが必要な場合は、お問い合わせください。

APIのレート制限はどう適用されますか?

制限値はレスポンスヘッダーで返されるため、クライアントは残りの容量を確認し、スロットリングされる前にバックオフできます。適用される値はプランによって異なります。ヘッダーを読み取って、無理なく速度を落とせるクライアントを実装してください。

メールをバッチで送信できますか?

プランに適用されるバッチのオプションと宛先の上限は、APIリファレンスでご確認ください。バッチの大きさにかかわらず、リクエストごとに冪等性キーを送信し、レート制限ヘッダーを守ってください。一部が失敗しても、重複なしで再試行できます。

MigoSMTPのMCPサーバーとは?

MCPサーバーは、AIアシスタントがツールを呼び出すための標準的な仕組みです。当社のサーバーを使うと、対応するエージェントが、お客様が管理するスコープ付きキーでメールAPIを操作し、たとえばメッセージのステータスを確認できます。送信には人の承認を必須にもできます。

対応している言語とSDKは?

HTTPS上のREST APIなので、HTTPリクエストを送れる言語ならどれでも利用できます。コピーしてすぐ使えるサンプルとSDKは、ドキュメントに掲載しています。APIキーは環境変数またはシークレットマネージャーに保管し、ソースコードには記述しないでください。

数分で送信を始めましょう。

アカウントを作成し、ドメインを追加して、最初のメールを送信します。