Temporary and Disposable emails API

About Temporary and Disposable emails API

Temporary Email is an API for creating, reading from, and deleting disposable email inboxes. It exposes three actions: creating a temporary email address, retrieving messages delivered to that address, and deleting the address. Email lifetime is controlled with a time parameter (10min, 1hour, 1day, or permanent), and a custom domain can optionally be specified when creating an address.

It is built for testing and automation workflows, such as verifying onboarding or confirmation emails, running QA against signup flows, or isolating disposable registrations in automated test suites, without exposing a primary email address or cluttering production mailboxes.

The service is published by Boomlify. The create endpoint accepts time and domain query parameters and returns a JSON object with email details including the address, creation and expiration timestamps, and remaining time. The retrieve-messages endpoint takes an email ID path parameter along with optional limit (default 25, max 100) and offset query parameters for pagination.

Key features

• Create disposable email addresses via API with configurable lifetime (10min, 1hour, 1day, permanent)
• Retrieve messages delivered to a temporary inbox by email UUID
• Delete a temporary email address when no longer needed
• Optionally specify a custom domain for the generated address
• Paginate retrieved messages using limit and offset query parameters

Frequently asked questions