Create Temporary Email

**Method:** POST
**Apiosk URL:** https://gateway.apiosk.com/apyhub-boomlify-temp-mail/boomlify/emails/create
**Request content type:** application/json
**Response content type:** application/json

What it does

Creates a temporary email address. You can control the email lifetime with the time query parameter and optionally provide a domain; the response returns the generated email data inside a JSON object.

Query Parameter(s)

| Attribute | Type | Mandatory | Description |
| --------- | ------ | --------- | ----------- |
| time | ENUM | No | Lifetime of the temporary email. Allowed values: 10min, 1hour, 1day, permanent. Default: 10min. |
| domain | String | No | Domain to use for the temporary email address. |

Response

Returns a JSON object with top-level data and success fields. The data field is an object containing meta and email objects; success is a boolean indicating whether the request was successful. The schema also defines top-level message and meta fields in the wrapper object.

| Parameter | Type | Mandatory | Description |
| --------- | ---- | --------- | ----------- |
| data | Object | No | Response payload object. Contains meta and email objects. |
| data.meta | Object | No | Metadata for the created temporary email. Contains tier, user_id, and request_time. |
| data.meta.tier | String | No | The tier associated with the request. |
| data.meta.user_id | String | No | The user identifier. |
| data.meta.request_time | String | No | Request timestamp in date-time format. |
| data.email | Object | No | Temporary email details. Contains id, domain, address, time_tier, created_at, expires_at, time_remaining, and is_custom_domain. |
| data.email.id | String | No | Email identifier in UUID format. |
| data.email.domain | String | No | Email domain. |
| data.email.address | String | No | Full email address. |
| data.email.time_tier | String | No | Time tier used for the email. |
| data.email.created_at | String | No | Creation timestamp in date-time format. |
| data.email.expires_at | String | No | Expiration timestamp in date-time format. |
| data.email.time_remaining | Object | No | Remaining time for the email. Contains minutes, seconds, total_ms, and human_readable. |
| data.email.time_remaining.minutes | Integer | No | Remaining minutes. |
| data.email.time_remaining.seconds | Integer | No | Remaining seconds. |
| data.email.time_remaining.total_ms | Integer | No | Remaining time in milliseconds. |
| data.email.time_remaining.human_readable | String | No | Human-readable remaining time. |
| data.email.is_custom_domain | Boolean | No | Indicates whether a custom domain was used. |
| data.success | Boolean | No | Indicates whether the operation succeeded. |
| meta | Object | No | Additional metadata about the request. Contains timestamp. |
| meta.timestamp | String | No | Request timestamp in date-time format. |
| message | String | No | Descriptive response message. |
| success | Boolean | No | Indicates if the request was successful. |

Quickstart

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

bash
curl -X POST "https://gateway.apiosk.com/apyhub-boomlify-temp-mail/boomlify/emails/create?time=10min" \
-H "PAYMENT-SIGNATURE: $PAYMENT_SIGNATURE"

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
}
}
}

Payment and authentication

Do not send an apy-token. Apiosk injects the APYHub credential server-side. The first unpaid request returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header. Sign an accepted USDC payment and retry the same request with the proof in PAYMENT-SIGNATURE (or use an Apiosk/x402-aware agent client that performs this exchange automatically).

The $PAYMENT_SIGNATURE placeholder in the example is the signed proof obtained from that initial 402 response.

Source

Parameter definitions and limits were synchronized from [APYHub's official documentation](https://apyhub.com/boomlify/service/temporary-and-disposable-emails-api) on 2026-07-18.