API

Welcome to the Disposable Mail Hub API.
Our API allows developers to generate temporary email addresses and retrieve incoming emails programmatically for testing, automation, and privacy-focused workflows.

What Is the Disposable Mail Hub API?

The Disposable Mail Hub API provides secure access to temporary email inboxes.
It is designed for:

• Developers & QA testers

• SaaS product testing

• Automation workflows

• Privacy-focused applications

⚠️ Note: The API is for receiving emails only. Sending emails is not supported.

Key Features

• Generate disposable email addresses

• Fetch incoming emails in real time

• No personal data required

• Fast & lightweight REST API

• Ideal for testing & development

Base API URL

(Replace with your actual API domain if different)

Authentication

Currently, the API supports:

• Public access (no authentication) for basic usage

• Optional API key authentication for higher limits or premium access

API Key Header (If Enabled)

API Endpoints

1. Generate a Disposable Email Address

Endpoint

Description
Creates a new temporary email address instantly.

Response Example

2. Get Inbox Messages

Endpoint

Parameters

Example Request

Response Example

3. Read a Specific Email

Endpoint

Parameters

Response Example

4. Delete an Email (Optional)

Endpoint

Description
Deletes a specific message from the inbox.

Rate Limits

To ensure fair usage:

• Free tier: 50 requests per hour

• Premium users: Higher limits available

Excessive requests may result in temporary IP blocking.

Email Expiration Policy

• Disposable email addresses are temporary

• All messages are automatically deleted after expiration

• Expired emails cannot be recovered

Allowed Use Cases

✅ Website testing
✅ App verification testing
✅ QA & automation
✅ Temporary sign-ups
✅ Privacy protection

Restricted Use

❌ Illegal activities
❌ Fraud or abuse
❌ Spamming services
❌ Bypassing security systems

Violation may result in API access suspension.

Security & Privacy

• No personal data is collected

• Emails are deleted automatically

• No tracking or profiling

• HTTPS encryption supported

For more details, see our Privacy Policy.

Common API Errors

API Status & Support

• API uptime: 99.9%

• Status updates available on the Status Page

📩 Support Email: support@disposablemailhub.com
(Replace with your real support email)

Frequently Asked Questions (API)

Is the API free to use?
Yes, basic usage is free with optional premium plans.

Can I use this API in production?
Yes, but disposable emails should not be used for sensitive accounts.

Do you log API requests?
Minimal logs are kept for performance and abuse prevention only.