---
title: Temporary and Disposable emails API
slug: create-temporary-email
url: https://apyverse.com/boomlify/service/create-temporary-email
provider: Boomlify
categories: [Communications, Data Validation, "Security & Privacy"]
auth: api_key
---

# Temporary and Disposable emails API

Create disposable inboxes, read incoming messages, and delete mailboxes. Useful for sign-up testing, QA, and short-lived verification flows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/boomlify/emails/create` | What it does Creates a temporary email address. You can control the email lifetime with the time qu… | 25 |
| GET | `/boomlify/emails/messages/:id` | What it does Retrieves email messages for the email address identified by the path id. The response… | 25 |
| DELETE | `/boomlify/emails/:id` | What it does Deletes a temporary email identified by its UUID path parameter. The response returns… | 25 |

## About

## What it does
Temporary Email lets you create disposable inboxes, read the messages that arrive there, and delete the mailbox when you are done. Use it when you need an email address for sign-up flows, verification testing, QA environments, or short-lived user journeys.

Send a `time` value of `10min`, `1hour`, `1day`, or `permanent` to `/create`. You can also pass a `domain` to request a specific domain. The response includes the created email object with its `id`, `domain`, `address`, `time_tier`, `created_at`, `expires_at`, `time_remaining`, and `is_custom_domain`, along with the request `success` flag and response metadata.

To inspect incoming mail, call `GET /messages/:id` with the mailbox UUID. You can page through results with `limit` and `offset`. The response returns the email `address`, `message_count`, and a `messages` array with each message’s `id`, `is_read`, `is_spam`, `subject`, `body_html`, `body_text`, `from_name`, `from_email`, and `received_at`, plus `pagination` details.

When the mailbox is no longer needed, delete it with `DELETE /:id`. The delete response includes the `user_id`, `email_id`, and `deleted_at` values in `data.meta`, so you can confirm cleanup in logs or automated test runs.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/boomlify/service/create-temporary-email