Centro de Documentación y Pruebas de la API de Temp Mail

Lee la documentación, prueba endpoints y copia código — todo en una sola página.

URL base:

https://v1.boomlify.com

Inicio rápido

Emails

💎 Dashboard API (Premium)

Cuenta

POST /api/v1/emails/create

Crear una nueva dirección de correo temporal Ahora admite el parámetro opcional custom_username para crear correos con direcciones personalizadas.

Requiere autenticaciónCon límite de tasa

Documentación

Parámetros

consulta

custom_username

Nombre de usuario personalizado opcional para la dirección de correo. Puede contener letras, números, puntos, guiones y guiones bajos. Debe tener entre 3 y 30 caracteres. Si se omite, se generará un nombre de usuario aleatorio.

Ejemplo: john.doe

⚠️ ⚠️ Debe tener entre 3 y 30 caracteres. No puede comenzar/terminar con caracteres especiales. Debe ser único. Devuelve 409 si ya está tomado.

consulta

time

Tiempo de expiración

Ejemplo: permanent

⚠️ Debe ser uno de: 10min, 1hour, 1day, permanent

consulta

domain

Dominio personalizado opcional para la dirección de correo. Debe ser un dominio verificado en tu cuenta (usa el endpoint custom_domains para verificar). Si no se especifica, se usará un dominio público aleatorio.

Ejemplo: mail.yourdomain.com

⚠️ ⚠️ Debe ser un dominio personalizado verificado o un dominio público. Devuelve 400 si no está disponible.

consulta

create_as_dashboard

💎 Función Premium - Establece en "true" para crear un correo estilo panel almacenado en la base de datos con expiración fija de 2 meses en lugar de un correo API basado en tiempo. Omite o establece en "false" para correos basados en tiempo (por defecto). Los correos del panel cuestan 15 créditos. Los usuarios del nivel gratuito recibirán un error 403.

Ejemplo: true

⚠️ ⚠️ Debe ser "true" u omitido. Los correos del panel requieren plan Basic o superior. Expiración fija de 2 meses (el parámetro tiempo se ignora).

Ejemplos de error

400

INVALID_USERNAME

El nombre de usuario debe tener al menos 3 caracteres

La validación del nombre de usuario personalizado falló. Debe tener entre 3 y 30 caracteres solo con caracteres válidos.

409

EMAIL_IN_USE

La dirección de correo "[email protected]" ya está en uso

El nombre de usuario personalizado ya está tomado. Elige un nombre de usuario diferente.

400

DOMAIN_NOT_FOUND

El dominio "custom.domain" no está disponible. Debe ser un dominio personalizado verificado en tu cuenta o un dominio público.

El dominio especificado no existe o no está verificado. Verifícalo primero en tu cuenta.

400

DOMAIN_NOT_VERIFIED

El dominio personalizado "custom.domain" no está verificado. Estado actual: pendiente

El dominio existe pero aún no está verificado. Completa primero la verificación del dominio.

429

DAILY_LIMIT_EXCEEDED

Límite diario excedido para correos de 1 hora

Has alcanzado tu límite diario para este tipo de correo

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

consulta

include_expired

Incluir correos expirados

Ejemplo: true

⚠️ Debe ser "true" o "false"

consulta

permanent_only

Mostrar solo tus buzones permanentes guardados. Cuesta 2 créditos por solicitud.

Ejemplo: true

⚠️ Debe ser "true" o "false"

consulta

include_permanent

Incluir tus buzones permanentes guardados junto con los recientes. Cuesta 2 créditos por solicitud.

Ejemplo: true

⚠️ Debe ser "true" o "false"

consulta

limit

Número de correos a devolver

Ejemplo: 50

⚠️ Máximo 100 correos

Ejemplos de error

402

INSUFFICIENT_CREDITS

Agrega créditos para listar buzones permanentes.

Devuelto cuando se intenta listar buzones permanentes guardados pero la cuenta carece de créditos.

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

ID del correo

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Debe ser un UUID válido

Ejemplos de error

404

EMAIL_NOT_FOUND

El correo solicitado no fue encontrado o ha expirado

El ID del correo es inválido o el correo ha expirado

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

ID del correo

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Debe ser un UUID válido

consulta

limit

Número de mensajes a devolver

Ejemplo: 50

⚠️ Máximo 100 mensajes

consulta

offset

Número de mensajes a omitir

Ejemplo: 0

⚠️ Debe ser un entero no negativo

Ejemplos de error

404

EMAIL_NOT_FOUND

El correo solicitado no fue encontrado o ha expirado

El ID del correo es inválido o el correo ha expirado

400

INVALID_LIMIT

El límite debe estar entre 1 y 100

El parámetro límite está fuera del rango válido

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

ID del correo (formato UUID). Puede ser un ID de correo API basado en tiempo o un ID de correo del panel creado con create_as_dashboard=true

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Debe ser un UUID válido

Ejemplos de error

404

EMAIL_NOT_FOUND

El correo solicitado no fue encontrado o ha expirado

El correo no existe o ya ha sido eliminado

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

consultaObligatorio

include_dashboard

Debe establecerse en "true" para acceder a los correos del panel. Esto activa la función premium y cobra 2 créditos.

Ejemplo: true

⚠️ Debe ser "true" - Los usuarios del nivel gratuito recibirán un error 403

consulta

include_expired

Incluir correos expirados en la respuesta (correos API y correos del panel)

Ejemplo: false

consulta

limit

Número máximo de correos a devolver (máx: 100)

Ejemplo: 50

⚠️ Debe estar entre 1 y 100

Ejemplos de error

403

TIER_RESTRICTED

El acceso a correos del panel requiere un plan de pago (Basic o superior)

Esta es una función premium. Los usuarios del nivel gratuito no pueden acceder a correos del panel a través de la API.

402

INSUFFICIENT_CREDITS

Se necesitan 2 créditos para listar correos del panel

Esta operación cuesta 2 créditos. Por favor, agrega más créditos a tu cuenta.

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

ID del correo del panel (formato UUID) - Copia esto desde tu panel o desde el endpoint list-dashboard-emails

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Debe ser un UUID válido de tus correos del panel

consultaObligatorio

include_dashboard

Debe ser "true" para buscar correos del panel. Cobra 1 crédito.

Ejemplo: true

Ejemplos de error

403

TIER_RESTRICTED

Función Premium

El acceso a correos del panel requiere un plan de pago

402

INSUFFICIENT_CREDITS

Se necesita 1 crédito para acceder al correo del panel

Esta operación cuesta 1 crédito

404

EMAIL_NOT_FOUND

Correo no encontrado

El correo solicitado no fue encontrado o ha expirado

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

ID del correo del panel - El UUID del correo para el cual deseas obtener mensajes

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Debe ser un UUID válido de tus correos del panel

consultaObligatorio

include_dashboard

Debe ser "true" para acceder a los mensajes del correo del panel. Cobra 1 crédito.

Ejemplo: true

consulta

limit

Número máximo de mensajes a devolver por página (máx: 100)

Ejemplo: 20

⚠️ Debe estar entre 1 y 100

consulta

offset

Número de mensajes a omitir para paginación (ej: offset=20 con limit=20 obtiene la página 2)

Ejemplo: 0

⚠️ Debe ser un entero no negativo

Ejemplos de error

403

TIER_RESTRICTED

Función Premium

El acceso a correos del panel requiere un plan de pago

402

INSUFFICIENT_CREDITS

Se necesita 1 crédito para acceder a los mensajes del correo del panel

Esta operación cuesta 1 crédito

404

EMAIL_NOT_FOUND

Correo no encontrado

El correo solicitado no fue encontrado o ha expirado

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

Mailbox ID - Use a dashboard mailbox ID or a permanent API mailbox ID whose Telegram forwarding status you want to inspect

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Must be an owned dashboard mailbox ID or permanent API mailbox ID

consultaObligatorio

include_dashboard

Must be set to "true" to access Telegram forwarding mailbox status. Charges 2 credits.

Ejemplo: true

⚠️ Must be "true" - Free tier users will receive a 403 error

Ejemplos de error

403

TIER_RESTRICTED

Dashboard email access requires a paid plan (Basic or higher)

This is a premium feature. Free tier users cannot access dashboard email forwarding via API.

402

INSUFFICIENT_CREDITS

Need 2 credits to access dashboard email Telegram forwarding status

This operation costs 2 credits. Please add more credits to your account.

404

EMAIL_NOT_FOUND

Email not found

The requested mailbox was not found, is unsupported, or has expired

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

rutaObligatorio

Mailbox ID - Use a dashboard mailbox ID or a permanent API mailbox ID whose Telegram forwarding you want to update

Ejemplo: 550e8400-e29b-41d4-a716-446655440000

⚠️ Must be an owned dashboard mailbox ID or permanent API mailbox ID

consultaObligatorio

include_dashboard

Must be set to "true" to update Telegram mailbox forwarding. Charges 2 credits.

Ejemplo: true

⚠️ Must be "true" - Free tier users will receive a 403 error

cuerpoObligatorio

is_enabled

Boolean body field. Set true to enable forwarding or false to disable forwarding.

Ejemplo: true

⚠️ Must be a boolean value

Ejemplos de error

403

TIER_RESTRICTED

Dashboard email access requires a paid plan (Basic or higher)

This is a premium feature. Free tier users cannot update dashboard email forwarding via API.

402

INSUFFICIENT_CREDITS

Need 2 credits to update dashboard email Telegram forwarding

This operation costs 2 credits. Please add more credits to your account.

400

NO_TELEGRAM_BINDING

No active Telegram binding found. Please bind your Telegram account first.

Forwarding cannot be enabled until the account has an active verified Telegram binding.

403

FORWARDING_LIMIT_EXCEEDED

Forwarding limit exceeded

The user has reached the plan limit for active Telegram forwardings.

404

EMAIL_NOT_FOUND

Email not found

The requested mailbox was not found, is unsupported, or has expired

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

consultaObligatorio

include_dashboard

Must be set to "true" to bulk enable Telegram mailbox forwarding. Charges 2 credits.

Ejemplo: true

⚠️ Must be "true" - Free tier users will receive a 403 error

cuerpoObligatorio

email_ids

Body field containing a non-empty array of owned mailbox IDs. In the test form, you can enter a single mailbox ID or a JSON array.

Ejemplo: ["550e8400-e29b-41d4-a716-446655440000"]

⚠️ Must resolve to a non-empty array of owned dashboard mailbox IDs or permanent API mailbox IDs. The bulk limit is 150 IDs per request.

Ejemplos de error

403

TIER_RESTRICTED

Dashboard email access requires a paid plan (Basic or higher)

This is a premium feature. Free tier users cannot bulk enable dashboard email forwarding via API.

402

INSUFFICIENT_CREDITS

Need 2 credits to bulk enable dashboard email Telegram forwarding

This operation costs 2 credits total per bulk request.

400

NO_TELEGRAM_BINDING

No active Telegram binding found. Please bind your Telegram account first.

Forwarding cannot be enabled until the account has an active verified Telegram binding.

403

FORWARDING_LIMIT_EXCEEDED

Forwarding limit exceeded

The user has reached the plan limit for active Telegram forwardings.

404

EMAIL_NOT_FOUND

Email not found

No matching forwardable mailboxes were found.

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Parámetros

consulta

create_as_dashboard

Establece en "true" para crear un correo estilo panel almacenado en la base de datos con expiración fija de 2 meses. Si se omite, crea un correo API basado en tiempo en memoria. Ambos admiten custom_username.

Ejemplo: true

⚠️ ⚠️ Los correos del panel cuestan 15 créditos. Expiración fija de 2 meses (sin parámetro tiempo). Los usuarios del nivel gratuito recibirán un error 403. Omite este parámetro para crear un correo API basado en tiempo con opciones de tiempo personalizadas.

consulta

custom_username

Ejemplo: john.doe

⚠️ ⚠️ Debe tener entre 3 y 30 caracteres. No puede comenzar/terminar con caracteres especiales. Debe ser único en todos tus correos. Si ya está tomado, devuelve 409 Conflict.

consulta

domain

Nombre de dominio personalizado opcional para la dirección de correo. Si no se especifica, se usará un dominio público aleatorio.

Ejemplo: mail.yourdomain.com

⚠️ Debe ser un dominio verificado en tu cuenta

Ejemplos de error

403

TIER_RESTRICTED

Función Premium

La creación de correos del panel requiere un plan de pago

402

INSUFFICIENT_CREDITS

Se necesitan 15 créditos para crear un correo del panel

Esta operación cuesta 15 créditos

400

INVALID_USERNAME

El nombre de usuario debe tener al menos 3 caracteres

La validación del nombre de usuario personalizado falló. Debe tener entre 3 y 30 caracteres solo con caracteres válidos.

409

EMAIL_IN_USE

La dirección de correo "[email protected]" ya está en uso

El nombre de usuario personalizado ya está tomado. Elige un nombre de usuario diferente.

400

INVALID_TIME_PARAMETER

Parámetro de tiempo inválido

El tiempo debe ser uno de: 10min, 1hour, 1day, permanent

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Ejemplos de error

401

UNAUTHORIZED

Clave API inválida o faltante

La clave API es requerida y debe ser válida

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Ejemplos de error

401

UNAUTHORIZED

Clave API inválida o faltante

La clave API es requerida y debe ser válida

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Documentación

Ejemplos de error

401

UNAUTHORIZED

Clave API inválida o faltante

La clave API es requerida y debe ser válida

Solicitud de ejemplo

curl -X POST "https://v1.boomlify.com/api/v1/emails/create"

Fragmentos de código

const response = await fetch("https://v1.boomlify.com/api/v1/emails/create", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
});

const data = await response.json();

import requests

response = requests.post("https://v1.boomlify.com/api/v1/emails/create", 
  headers={
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json"
  }
)

data = response.json()

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://v1.boomlify.com/api/v1/emails/create");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: YOUR_API_KEY",
  "Content-Type": "application/json"
]);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

Límite: 60 RPMCentro API

Probar API

Centro de Documentación y Pruebas de la API de Temp Mail

Lee la documentación, prueba endpoints y copia código — todo en una sola página.

POST /api/v1/emails/create

Documentación

Parámetros

Ejemplos de error

Solicitud de ejemplo

Fragmentos de código

Chat de la Comunidad

Temp Mail - Free Temporary Email Generator with Custom Domain Support