テストと自動化のための一時メールAPI
コードから受信専用の一時メールアドレスを作成し、届いたメッセージをJSONで取得できます。各アドレスは削除するまでTmailorアカウントに残り、APIはメッセージ内で見つけたワンタイムコードを返します。
最終更新日:October 2026
- REST と JSON
- SDK、CLI、MCPサーバー
- 毎月100件の無料メールボックス
- 受信専用、メッセージは24時間保存
export TMAILOR_API_KEY="tmk_live_..."
# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
-H "Authorization: Bearer $TMAILOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{}'# pip install tmailor-sdk
from tmailor import Client
with Client() as client: # reads TMAILOR_API_KEY
box = client.mailboxes.create()
print(box.email)
# trigger the email, then wait for it
msg = box.wait_for_message(
timeout=120, since=(box.created_at or 0) - 1)
print(msg.subject, msg.otp(), msg.links())// npm install tmailor
import { Client } from "tmailor";
const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);
// trigger the email, then wait for it
const msg = await box.waitForMessage({
timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);<?php // composer require tmailor/tmailor
use Tmailor\Client;
$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";
// trigger the email, then wait for it
$msg = $box->waitForMessage(
timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp; アドレスを作成し、メールを待って、コードを読み取ります。
課金はリクエスト単位ではなくメールボックス単位
メールボックス枠を消費するのはアドレスの作成のみです。アドレスの一覧表示、受信トレイの確認、メッセージの閲覧や削除では消費されません。有料プランには日次・月次のリクエスト上限はなく、1分あたりのレート制限のみです。
例: アドレスを1つ作成し、受信トレイを25回確認するOTPテストでも、使用するメールボックスは1つです。
APIキーから受信箱まで4ステップ
-
APIキーを作成する
tmailor.com アカウントまたは Google で API プラットフォームにサインインし、キーを作成します。無料プランでは、API を呼び出すサーバーの IP アドレスを1つ追加する必要もあります。
-
アドレスを作成する
1回のリクエストで共有ドメインのランダムなアドレスを取得するか、所有・認証済みのドメインでカスタム名を指定できます。
-
メッセージを読む
受信箱を一覧表示し、各メッセージをJSONで読み取ります。送信者、件名、テキスト、サニタイズ済みHTML、そしてAPIが検出したワンタイムコードとリンクが含まれます。
-
残すか削除するか
アドレスに有効期限はありません。tmailor.com の再利用リンクで同じ受信箱を開くか、テストが終わったらアドレスを削除してください。
繰り返し実行できるメールワークフロー向け
1つの実メールボックスを共有する代わりに、テスト実行ごとに専用の受信箱を用意できます。
サインアップとOTPのテスト
サインアップ、パスワードリセット、ワンタイムコードの確認ごとに新しいアドレスを作成し、レスポンスからコードを読み取ります。
CI/CDパイプライン
パイプライン内で、APIキーを環境変数に設定してエンドツーエンドのメールチェックを実行できます。有料プランはどのIPアドレスからのリクエストも受け付けます。
QAとステージング
テスターやステージング環境に専用のアドレスを割り当て、実際の受信箱がテストデータに混ざらないようにします。
独自ドメイン上のアドレス
a domain you ownを追加し、そのMXレコードを当社に向けて設定すると、命名ルールに従ったカスタム名のアドレスを作成できます。
プランと料金
必要なメールボックス数を選択してください。利用枠は30日ごとにリセットされ、年間プランでも同様です。
無料
APIを試したり、小規模なプロジェクトに最適です。
$0 /月
$0 /月
- 30日ごとに100個のメールボックス
- 1分あたり最大30リクエスト
- 1日あたり2,000リクエスト
- 許可リストに登録した1つのIPからの呼び出し
- 共有ドメインと独自ドメイン
スターター
開発者1人や小規模なテストスイート向けです。
$9 /月
$90 /年
- 30日ごとに3,000個のメールボックス
- 1分あたり最大300リクエスト
- 日次・月次のリクエスト上限なし
- 任意のIPアドレスからの呼び出し
- 共有ドメインと独自ドメイン
Pro
毎日テストを実行するチーム向けです。
$29 /月
$290 /年
- 30日ごとに30,000個のメールボックス
- 1分あたり最大600リクエスト
- 日次・月次のリクエスト上限なし
- 任意のIPアドレスからの呼び出し
- 共有ドメインと独自ドメイン
ビジネス
日々の自動化処理が多い企業向けです。
$99 /月
$990 /年
- 30日ごとに150,000個のメールボックス
- 1分あたり最大2,000リクエスト
- 日次・月次のリクエスト上限なし
- 任意のIPアドレスからの呼び出し
- 共有ドメインと独自ドメイン
Scale
大規模なテスト群や高負荷なパイプライン向けです。
$199 /月
$1,990 /年
- 30日ごとに400,000個のメールボックス
- 1分あたり最大4,000リクエスト
- 日次・月次のリクエスト上限なし
- 任意のIPアドレスからの呼び出し
- 共有ドメインと独自ドメイン
Enterprise
最大のメールボックス数とリクエストレートが必要な方向けです。
$499 /月
$4,990 /年
- 30日ごとに2,000,000個のメールボックス
- 1分あたり最大6,000リクエスト
- 日次・月次のリクエスト上限なし
- 任意のIPアドレスからの呼び出し
- 共有ドメインと独自ドメイン
プランの比較
これらの上限はプランごとに異なります。それ以外はすべてのプランで共通です。
| プラン | 無料 | スターター | Pro | ビジネス | Scale | Enterprise |
|---|---|---|---|---|---|---|
| 月額料金 | $0 | $9 | $29 | $99 | $199 | $499 |
| 年額料金 | $0 | $90 | $290 | $990 | $1,990 | $4,990 |
| 30日ごとのメールボックス数 | 100 | 3,000 | 30,000 | 150,000 | 400,000 | 2,000,000 |
| 1分あたりのリクエスト数 | 30 | 300 | 600 | 2,000 | 4,000 | 6,000 |
| 1日あたりのリクエスト上限 | 2,000 | 上限なし | 上限なし | 上限なし | 上限なし | 上限なし |
| IP許可リスト | 必須、1 IP | 不要 | 不要 | 不要 | 不要 | 不要 |
| ホスト型MCPサーバー | ローカルサーバーのみ | 含まれる | 含まれる | 含まれる | 含まれる | 含まれる |
横にスワイプするとすべてのプランを比較できます。
すべてのプランに共通
- JSONレスポンスを返すREST API
- 共有ドメインのランダムなアドレス
- 認証済みの独自ドメインでのカスタム名
- 独自ドメインは無制限(同時に認証待ちにできるのは3件まで)
- 有効期限のないアドレス
- 保持できるアドレス数に制限なし
- メッセージは24時間保存されます
- ワンタイムコードとリンクの抽出(ベストエフォート)
- tmailor.comで受信トレイを開く再利用リンク
- 公式SDKとコマンドラインツール
- プランは組み合わせ可能で、上限は合算されます
- 受信専用、添付ファイルなし
- アドレスを削除してもクォータは戻りません
- メールボックスの上限に達すると、次のサイクルまで、またはアップグレードするまで新しいアドレスは作成できません。既存の受信箱は引き続き利用できます。
- お支払いいただいた料金はAPI利用規約に基づき返金されません。まずは無料プランで連携をテストしてください。
公式SDKとCLI
お使いの言語からAPIを呼び出せます。型付きモデル、自動リトライ、次のメッセージを待つヘルパーを備えています。すべてのSDKは同じAPIと同じテストシナリオに準拠しています。
AIエージェント用MCPサーバー
Claude、Cursor、VS Code CopilotなどのMCPクライアントで、ご自身が所有する、またはテストを許可されているサインアップフローをテストできます。エージェントは実際の受信専用アドレスを作成し、メールの到着を待って、ワンタイムコードや認証リンクを読み取ります。
どちらの方法でも、エージェントに同じツールが提供されます。アドレスの作成、メールの到着待ちとワンタイムコード・リンクの取得、メッセージの読み取り、アドレスの削除、クォータの確認ができます。エージェントが見られるのはメールアドレスのみで、その背後にあるトークンは見えません。また、APIと同じメールボックスのクォータとレート制限が適用されます。
ホスト型サーバー
インストール不要https://mcp.tmailor.com/mcp
AIアプリにサーバーURLを追加してください。Claude、ChatGPT、Codexなどサインインに対応するアプリでは、アクセスを承認するためにTmailorプラットフォームへ移動します。その他のクライアントはAuthorizationヘッダーでAPIキーを送信します。
有効な有料プランが必要です。リクエストは当社のサーバーから送信されるため、IP許可リストの登録は不要です。
# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp
# Claude Code, with your API key
claude mcp add --transport http tmailor \
https://mcp.tmailor.com/mcp \
--header "Authorization: Bearer tmk_live_..."
# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
--url https://mcp.tmailor.com/mcp \
--bearer-token-env-var TMAILOR_API_KEY
# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
"url": "https://mcp.tmailor.com/mcp",
"headers": {"Authorization": "Bearer tmk_live_..."}}}} AI connectionsページで接続済みのアプリを確認し、任意のアプリを切断できます。切断されたアプリは30秒以内にアクセスできなくなります。
ローカルサーバー
無料プランを含む全プランで利用可能tmailor-mcp
お使いのコンピューター上で動作し、TMAILOR_API_KEYからキーを読み取り、uvまたはPython 3.10+が必要です。無料プランでは、そのコンピューターのIPアドレスを許可リストに追加してください。
# Claude Code claude mcp add tmailor \ -e TMAILOR_API_KEY=tmk_live_... \ -- uvx tmailor-mcp # Claude Desktop, Cursor, VS Code # command: uvx args: ["tmailor-mcp"] # without uv pip install tmailor-mcp
「一時メールを作成して、私のステージングサイトにそれで登録し、認証コードを教えて」と頼んでみてください。
一時メールAPI FAQ
メールボックスとしてカウントされるのは何ですか?
新しいアドレスを作成するたびに、現在の30日サイクルの許容枠からメールボックスを1つ消費します。一覧表示、閲覧、削除ではメールボックスを消費せず、アドレスを削除してもメールボックスは戻りません。
アドレスは期限切れになりますか?
いいえ。アドレスは削除するまでアカウントに残ります。メッセージは24時間保存されます。
メールの送信や添付ファイルの受信はできますか?
いいえ。APIは受信専用で、添付ファイルは配信されません。
アドレス名とドメインは選べますか?
共有ドメインでは名前はランダムです。名前を選ぶには、APIプラットフォーム上で所有するドメインを追加して検証し、そのMXレコードを当社に向けて設定したうえで、命名ルールに従ったカスタム名でアドレスを作成します。
IP許可リストは必要ですか?
無料プランのみ、サーバーがアクセスするIPアドレスを1つ登録する必要があります。1つのIPアドレスは1つの無料アカウントにしか紐付けられないため、共有オフィスやVPNのアドレスはすでに使用されている可能性があります。有効な有料プランでは、APIは任意のIPアドレスからのリクエストを受け付けます。
APIは認証コードを読み取ってくれますか?
はい、ベストエフォートで行います。メッセージを読むと、レスポンスには検出したワンタイムコード(確信が持てない場合はnull)、その他のコードらしき値、リンクが含まれます。テストでは必ず値を確認してください。
ClaudeやChatGPTなどのAIエージェントはAPIを利用できますか?
はい、MCPを通じて利用できます。有料プランでは、ホスト型サーバー https://mcp.tmailor.com/mcp をAIアプリに追加してアクセスを承認するか、APIキーを送信してください。どのプランでも、オープンソースのtmailor-mcpサーバーを自分のパソコンで実行できます。いずれの場合も、エージェントはアドレスを作成し、メールを待ち、ワンタイムコードを読み取ることができ、APIと同じメールボックスの割り当てを使用します。
有料プランにはリクエストの上限がありますか?
有料プランには日次・月次のリクエストクォータはありませんが、各プランには1分あたりのレート制限があります。無料プランにはさらに1日あたりのリクエスト上限があります。
始めるのにクレジットカードは必要ですか?
いいえ。tmailor.com アカウントまたはGoogleでサインインし、キーを作成すれば無料プランで始められます。支払いが発生するのは有料プランを選んだときだけです。
プランの支払い方法は?
USDTをTRC20(Tron)またはBEP20(BNB Smart Chain)ネットワークで支払うか、Binance Payで支払えます。クレジットカードやデビットカードは受け付けていません。プランは支払いの確認後、通常数分以内に有効になります。
返金はできますか?
いいえ。支払いは返金不可のため、アップグレード前に無料プランで連携をテストしてください。
APIが許可されていない用途は何ですか?
スパム、詐欺、他のサービスでの一括アカウント作成、およびそれらのサービスの禁止措置や制限の回避はAPI利用規約に違反します。こうした行為を行うアカウントのAPIキーを取り消し、アカウントをロックする場合があります。