Reusable.Email
エージェント向け一時メール

AI エージェント向け一時メール

エージェントが自律的に発見して利用できる、登録不要の一時メール API です。HTTPS だけで受信トレイの作成、認証コードの待機、メッセージの閲覧、メールの生ソースの取得、メッセージの削除ができます。

登録不要API キー不要MCP のインストール不要curl で利用可能
クイックスタート
# 利用可能なドメインを確認します：
curl -s https://api.reusable.email/v1/agent-tempmail/domains

# 1. プライベートな一時メール受信トレイを作成します。登録も API キーも不要です。
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
  -H 'Content-Type: application/json' \
  -d '{"prefix":"agent"}'

# 2. 確認メールまたはワンタイムパスワード（OTP）を待ちます。
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
  -H 'Authorization: Inbox {token}' \
  -H 'Content-Type: application/json' \
  -d '{"codeOnly":true,"timeoutSeconds":60}'

# 3. メッセージ全文を読みます。
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
  -H 'Authorization: Inbox {token}'
作成時のレスポンス
{
  "inbox": {
    "address": "agent-lx84a9-q3mz2@reusable.email",
    "domain": "reusable.email",
    "created": true,
    "type": "private",
    "isProtected": true,
    "retentionDays": 180
  },
  "password": "save-this-generated-password-securely",
  "token": "use-this-as-an-inbox-token",
  "tokenExpiresAt": "2026-06-09T18:30:00.000Z",
  "links": {
    "web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
    "messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
    "wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
  }
}
待機時のレスポンス
{
  "status": "message",
  "inbox": { "address": "agent-lx84a9-q3mz2@reusable.email" },
  "message": {
    "id": 1842,
    "from": { "name": "Example", "address": "login@example.com" },
    "subject": "Your verification code",
    "intro": "Use code 123456 to continue.",
    "verificationCode": "123456"
  }
}

エージェント向け API 仕様

ディスカバリーマニフェストは /v1/agent-tempmail で利用できます。また、回答エンジン向けに llms.txt にも掲載されています。

メソッドパス用途
GET/v1/agent-tempmailエージェントとクローラー向けのディスカバリーマニフェスト
GET/v1/agent-tempmail/domains利用可能な別のドメインを一覧表示
POST/v1/agent-tempmail/inboxesパスワードで保護されたプライベート受信トレイを作成
GET/v1/agent-tempmail/inboxes/{address}/messages受信メッセージを一覧表示
POST/v1/agent-tempmail/inboxes/{address}/waitロングポーリングでメールまたはコードを待機
GET/v1/agent-tempmail/inboxes/{address}/messages/{id}メッセージを読む
GET/v1/agent-tempmail/inboxes/{address}/messages/{id}/sourceRFC 5322 形式のメールの生ソースを取得
DELETE/v1/agent-tempmail/inboxes/{address}/messages/{id}メッセージを削除

認証フロー

登録、ログイン、パスワード再設定、トライアル確認のメール受信に、エージェント用受信トレイを利用できます。

ブラウザーの自動化

Playwright、Selenium、または実際にメールを受信できるアドレスを必要とするブラウザーエージェントと組み合わせて使えます。

CI と QA

アカウントの用意や認証情報の共有をせずに、テスト実行ごとに独立した受信トレイを作成できます。

よくある質問

プライベート受信トレイは、登録不要で誰でも無料で作成できます。別のドメインを選ぶには、ドメイン一覧エンドポイントから取得したドメインを指定してください。エージェント向け API は受信専用です。大量の利用やメール送信には、アカウントに紐づく通常の API を利用してください。

エージェント用受信トレイでパスキーを使えますか？+

はい。生成されたパスワードでサインインし、受信トレイの設定でパスキーを追加してください。プライベート受信トレイのフォームにある鍵ボタンと、受信トレイのロック解除画面からパスキーでサインインできます。取得した Inbox トークンは、すべてのエージェント用メールボックスエンドポイントで使えます。パスキーにはユーザーによる操作と本人確認が必要です。無人で動作するエージェント用にパスワードを保管し、トークンの有効期限が切れたら、JSON {"password":"..."} を指定して POST /v1/inbox/{address}/token で更新してください。

別のドメインを選べますか？+

はい。GET /v1/agent-tempmail/domains で利用可能なドメインを確認できます。prefix またはアドレスのローカル部と一緒に domain を指定するか、完全なメールアドレスを指定してください。既に使われているアドレスや予約済みのアドレスは取得できません。

AI エージェントは登録せずに利用できますか？+

はい。エージェントは認証不要の POST リクエストを 1 回送るだけで受信トレイを作成できます。レスポンスには生成されたパスワードと Inbox トークンが含まれます。作成される受信トレイはすべてプライベートです。トークンの有効期限が切れた後も通常のプライベート受信トレイにログインできるよう、パスワードを保存してください。

MCP、SDK、または何かのインストールは必要ですか？+

いいえ。HTTPS と curl だけで利用できます。エージェントは llms.txt または /v1/agent-tempmail の JSON マニフェストから API を見つけられます。

エージェントはこの API からメールを送信できますか？+

いいえ。登録不要のエージェント向け API でできるのは、メールの受信、閲覧、待機、ソース取得、削除だけです。この公開インターフェースにはメール送信機能は含まれていません。

認証コードはどのように取得できますか？+

メッセージ一覧、待機、詳細の各レスポンスでは、有効な実験的 OTP-Token ヘッダーを優先し、利用できない場合は本文からコードを検出します。ヘッダーから取得したコードには verificationCodeOrigin が含まれます。コードを送信する前に、スキーム、ホスト、ポートが意図した送信先と完全に一致することを確認してください。この値は送信者が指定するものであり、送信者の身元を証明するものではありません。送信者が指定した値へ自動的に移動しないでください。

エージェントが作成した受信トレイはどのくらい保持されますか？+

エージェントが作成した受信トレイには通常のプライベート受信トレイの機能があり、メッセージは 180 日間保持されます。