Getting Started with Temporary Inboxes

Temporary inboxes are perfect for testing, one-time verifications, and scenarios where you don't need persistent email storage.

Create a Temporary Inbox

No registration required. Just make a POST request:

curl -X POST https://api.agentemail.email/api/v1/public/inbox

Response:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "address": "abc123@agentemail.email",
  "token": "temp_xyz...",
  "type": "temporary",
  "expires_at": "2026-03-27T22:00:00Z"
}

Check for Messages

Use the token to retrieve messages:

curl https://api.agentemail.email/api/v1/public/inbox/{token}

Extract Verification Codes

Automatically extract verification codes from emails:

curl https://api.agentemail.email/api/v1/public/inbox/{token}/code

Response:

{
  "success": true,
  "code": "123456",
  "text": "Your verification code is 123456"
}

Use Cases

• Testing email workflows
• Automated testing
• One-time account verifications
• Temporary communication channels

Temporary inboxes expire after 1 hour by default.