---
title: Temporary and Disposable Emails API
slug: temporary-and-disposable-emails-api
url: https://apyhub.com/boomlify/service/temporary-and-disposable-emails-api
provider: Boomlify
tags: [temporary-email, disposable-email, email-inbox, throwaway-email, email-testing]
auth: api_key
---

# Temporary and Disposable Emails API

Create disposable inboxes, retrieve delivered messages, and delete them when done. Built for signup testing, QA, and privacy-focused workflows.

## Endpoints

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

## Examples

### Create Temporary Email

#### Quickstart

Create a temporary email address with the default 10-minute lifetime.

```bash
curl -X POST "https://api.eu.apyhub.com/boomlify/emails/create?time=10min" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with top-level `success` and `message` fields, a `meta` object with a `timestamp`, and a `data` object containing the created email details.

- `success` is a boolean indicating whether the request succeeded.
- `message` is a status string.
- `meta.timestamp` is an ISO 8601 date-time string.
- `data` is an object that includes `email`, `meta`, and `success`.

```json
{
  "success": true,
  "message": "Request processed successfully",
  "meta": {
    "timestamp": "2023-10-27T10:00:00Z"
  },
  "data": {
    "success": true,
    "meta": {
      "tier": "10min",
      "user_id": "user_123",
      "request_time": "2023-10-27T10:00:00Z"
    },
    "email": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "domain": "example.com",
      "address": "demo@example.com",
      "time_tier": "10min",
      "created_at": "2023-10-27T10:00:00Z",
      "expires_at": "2023-10-27T10:10:00Z",
      "time_remaining": {
        "minutes": 10,
        "seconds": 0,
        "total_ms": 600000,
        "human_readable": "10 minutes"
      },
      "is_custom_domain": false
    }
  }
}
```

### Retrieve Email Messages

#### Quickstart

Fetch a single message by its UUID.

```bash
curl -X GET "https://api.eu.apyhub.com/boomlify/emails/messages/:id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `data`, `meta`, `message`, and `success` fields. The `data` field is an object containing the message response payload, `meta.timestamp` is a date-time string, `message` is a status message, and `success` is a boolean.

```json
{
  "data": {},
  "meta": {
    "timestamp": "2023-10-27T10:00:00Z"
  },
  "message": "Request processed successfully",
  "success": true
}
```

### Delete Temporary Email

#### Quickstart

Delete a temporary email by its UUID `id`.

```bash
curl -X DELETE "https://api.eu.apyhub.com/boomlify/emails/:id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `data`, `meta`, `message`, and `success` fields. The `data` field is an object containing response details such as `meta`, `message`, and `success`.

```json
{
  "data": {
    "meta": {
      "user_id": "user_123",
      "email_id": "550e8400-e29b-41d4-a716-446655440000",
      "deleted_at": "2023-10-27T10:00:00Z"
    },
    "message": "Request processed successfully",
    "success": true
  },
  "meta": {
    "timestamp": "2023-10-27T10:00:00Z"
  },
  "message": "Request processed successfully",
  "success": true
}
```

## About

## What it does
Temporary Email gives you disposable email addresses you can create, read from, and delete through a simple API. Use it when you need a short-lived inbox for signups, verification flows, QA, or any workflow where you do not want to expose a primary address.

The service exposes three actions: create a temporary email, retrieve messages delivered to that inbox, and delete the address when you are done. The schemas are minimal, so the catalog reflects that minimal interface: requests and responses are empty objects in the spec, and the API is designed around the lifecycle of the inbox itself rather than extra metadata.

Use Temporary Email when you need to test onboarding emails, confirm that your product sends the right messages, or isolate disposable registrations during automation. It fits cleanly into test suites and internal tooling where short-lived inboxes help keep production mailboxes clean.

Because the API is focused on inbox lifecycle, it stays straightforward to integrate alongside existing email and verification systems.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/boomlify/service/temporary-and-disposable-emails-api