Temp Mail API – Dokumentation & Test‑Hub

Dokumentation lesen, Endpunkte testen und Code kopieren – alles auf einer Seite.

Basis‑URL:

https://v1.boomlify.com

Schnellstart

E‑Mails

💎 Dashboard API (Premium)

Konto

POST /api/v1/emails/create

Neue temporäre E-Mail-Adresse erstellen Unterstützt jetzt den optionalen custom_username-Parameter zum Erstellen von E-Mails mit personalisierten Adressen.

Authentifizierung erforderlichRate‑Limit

Dokumentation

Parameter

query

custom_username

Optionaler benutzerdefinierter Benutzername für die E-Mail-Adresse. Kann Buchstaben, Zahlen, Punkte, Bindestriche und Unterstriche enthalten. Muss 3-30 Zeichen lang sein. Wenn weggelassen, wird ein zufälliger Benutzername generiert.

Beispiel: john.doe

⚠️ ⚠️ Muss 3-30 Zeichen lang sein. Darf nicht mit Sonderzeichen beginnen/enden. Muss eindeutig sein. Gibt 409 zurück, wenn bereits vergeben.

query

time

Ablaufzeit

Beispiel: permanent

⚠️ Muss eines von sein: 10min, 1hour, 1day, permanent

query

domain

Optionale benutzerdefinierte Domain für die E-Mail-Adresse. Muss eine in Ihrem Konto verifizierte Domain sein (verwenden Sie den custom_domains-Endpunkt zur Verifizierung). Wenn nicht angegeben, wird eine zufällige öffentliche Domain verwendet.

Beispiel: mail.yourdomain.com

⚠️ ⚠️ Muss eine verifizierte benutzerdefinierte Domain oder eine öffentliche Domain sein. Gibt 400 zurück, wenn nicht verfügbar.

query

create_as_dashboard

💎 Premium-Funktion - Auf "true" setzen, um eine Dashboard-E-Mail zu erstellen, die in der Datenbank mit fester 2-Monats-Ablaufzeit gespeichert wird, anstatt einer zeitbasierten API-E-Mail. Weglassen oder auf "false" setzen für zeitbasierte E-Mails (Standard). Dashboard-E-Mails kosten 15 Credits. Free-Tier-Benutzer erhalten einen 403-Fehler.

Beispiel: true

⚠️ ⚠️ Muss "true" sein oder weggelassen werden. Dashboard-E-Mails erfordern Basic-Plan oder höher. Feste 2-Monats-Ablaufzeit (Zeitparameter wird ignoriert).

Fehlerbeispiele

400

INVALID_USERNAME

Benutzername muss mindestens 3 Zeichen lang sein

Validierung des benutzerdefinierten Benutzernamens fehlgeschlagen. Muss 3-30 Zeichen mit nur gültigen Zeichen sein.

409

EMAIL_IN_USE

E-Mail-Adresse "[email protected]" wird bereits verwendet

Der benutzerdefinierte Benutzername ist bereits vergeben. Wählen Sie einen anderen Benutzernamen.

400

DOMAIN_NOT_FOUND

Domain "custom.domain" ist nicht verfügbar. Sie muss entweder eine verifizierte benutzerdefinierte Domain in Ihrem Konto oder eine öffentliche Domain sein.

Die angegebene Domain existiert nicht oder ist nicht verifiziert. Verifizieren Sie sie zuerst in Ihrem Konto.

400

DOMAIN_NOT_VERIFIED

Benutzerdefinierte Domain "custom.domain" ist nicht verifiziert. Aktueller Status: ausstehend

Die Domain existiert, ist aber noch nicht verifiziert. Schließen Sie zuerst die Domain-Verifizierung ab.

429

DAILY_LIMIT_EXCEEDED

Tageslimit für 1-Stunden-E-Mails überschritten

Sie haben Ihr Tageslimit für diesen E-Mail-Typ erreicht

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

query

include_expired

Abgelaufene E-Mails einschließen

Beispiel: true

⚠️ Muss "true" oder "false" sein

query

permanent_only

Nur Ihre gespeicherten permanenten Postfächer anzeigen. Kostet 2 Credits pro Anfrage.

Beispiel: true

⚠️ Muss "true" oder "false" sein

query

include_permanent

Ihre gespeicherten permanenten Postfächer zusammen mit den neuesten einschließen. Kostet 2 Credits pro Anfrage.

Beispiel: true

⚠️ Muss "true" oder "false" sein

query

limit

Anzahl der zurückzugebenden E-Mails

Beispiel: 50

⚠️ Maximal 100 E-Mails

Fehlerbeispiele

402

INSUFFICIENT_CREDITS

Fügen Sie Credits hinzu, um permanente Postfächer aufzulisten.

Zurückgegeben beim Versuch, gespeicherte permanente Postfächer aufzulisten, aber das Konto hat unzureichende Credits.

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

E-Mail-ID

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

⚠️ Muss eine gültige UUID sein

Fehlerbeispiele

404

EMAIL_NOT_FOUND

Die angeforderte E-Mail wurde nicht gefunden oder ist abgelaufen

E-Mail-ID ist ungültig oder E-Mail ist abgelaufen

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

E-Mail-ID

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

⚠️ Muss eine gültige UUID sein

query

limit

Anzahl der zurückzugebenden Nachrichten

Beispiel: 50

⚠️ Maximal 100 Nachrichten

query

offset

Anzahl der zu überspringenden Nachrichten

Beispiel: 0

⚠️ Muss eine nicht-negative Ganzzahl sein

Fehlerbeispiele

404

EMAIL_NOT_FOUND

Die angeforderte E-Mail wurde nicht gefunden oder ist abgelaufen

E-Mail-ID ist ungültig oder E-Mail ist abgelaufen

400

INVALID_LIMIT

Limit muss zwischen 1 und 100 liegen

Limit-Parameter liegt außerhalb des gültigen Bereichs

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

E-Mail-ID (UUID-Format). Kann eine zeitbasierte API-E-Mail-ID oder eine Dashboard-E-Mail-ID sein, die mit create_as_dashboard=true erstellt wurde

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

⚠️ Muss eine gültige UUID sein

Fehlerbeispiele

404

EMAIL_NOT_FOUND

Die angeforderte E-Mail wurde nicht gefunden oder ist abgelaufen

E-Mail existiert nicht oder wurde bereits gelöscht

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

queryPflichtfeld

include_dashboard

Muss auf "true" gesetzt werden, um auf Dashboard-E-Mails zuzugreifen. Dies aktiviert die Premium-Funktion und berechnet 2 Credits.

Beispiel: true

⚠️ Muss "true" sein - Free-Tier-Benutzer erhalten einen 403-Fehler

query

include_expired

Abgelaufene E-Mails in die Antwort einschließen (sowohl API- als auch Dashboard-E-Mails)

Beispiel: false

query

limit

Maximale Anzahl zurückzugebender E-Mails (max: 100)

Beispiel: 50

⚠️ Muss zwischen 1 und 100 liegen

Fehlerbeispiele

403

TIER_RESTRICTED

Dashboard-E-Mail-Zugriff erfordert einen kostenpflichtigen Plan (Basic oder höher)

Dies ist eine Premium-Funktion. Free-Tier-Benutzer können nicht über die API auf Dashboard-E-Mails zugreifen.

402

INSUFFICIENT_CREDITS

Benötigt 2 Credits, um Dashboard-E-Mails aufzulisten

Diese Operation kostet 2 Credits. Bitte fügen Sie Ihrem Konto weitere Credits hinzu.

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

Dashboard-E-Mail-ID (UUID-Format) - Kopieren Sie dies aus Ihrem Dashboard oder vom list-dashboard-emails-Endpunkt

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

⚠️ Muss eine gültige UUID aus Ihren Dashboard-E-Mails sein

queryPflichtfeld

include_dashboard

Muss "true" sein, um Dashboard-E-Mails zu durchsuchen. Berechnet 1 Credit.

Beispiel: true

Fehlerbeispiele

403

TIER_RESTRICTED

Premium-Funktion

Dashboard-E-Mail-Zugriff erfordert einen kostenpflichtigen Plan

402

INSUFFICIENT_CREDITS

Benötigt 1 Credit, um auf Dashboard-E-Mail zuzugreifen

Diese Operation kostet 1 Credit

404

EMAIL_NOT_FOUND

E-Mail nicht gefunden

Die angeforderte E-Mail wurde nicht gefunden oder ist abgelaufen

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

Dashboard-E-Mail-ID - Die UUID der E-Mail, für die Sie Nachrichten abrufen möchten

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

⚠️ Muss eine gültige UUID aus Ihren Dashboard-E-Mails sein

queryPflichtfeld

include_dashboard

Muss "true" sein, um auf Dashboard-E-Mail-Nachrichten zuzugreifen. Berechnet 1 Credit.

Beispiel: true

query

limit

Maximale Anzahl zurückzugebender Nachrichten pro Seite (max: 100)

Beispiel: 20

⚠️ Muss zwischen 1 und 100 liegen

query

offset

Anzahl der für die Paginierung zu überspringenden Nachrichten (z. B. offset=20 mit limit=20 ergibt Seite 2)

Beispiel: 0

⚠️ Muss eine nicht-negative Ganzzahl sein

Fehlerbeispiele

403

TIER_RESTRICTED

Premium-Funktion

Dashboard-E-Mail-Zugriff erfordert einen kostenpflichtigen Plan

402

INSUFFICIENT_CREDITS

Benötigt 1 Credit, um auf Dashboard-E-Mail-Nachrichten zuzugreifen

Diese Operation kostet 1 Credit

404

EMAIL_NOT_FOUND

E-Mail nicht gefunden

Die angeforderte E-Mail wurde nicht gefunden oder ist abgelaufen

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

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

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

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

queryPflichtfeld

include_dashboard

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

Beispiel: true

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

Fehlerbeispiele

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

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

pfadPflichtfeld

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

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

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

queryPflichtfeld

include_dashboard

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

Beispiel: true

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

bodyPflichtfeld

is_enabled

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

Beispiel: true

⚠️ Must be a boolean value

Fehlerbeispiele

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

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

queryPflichtfeld

include_dashboard

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

Beispiel: true

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

bodyPflichtfeld

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.

Beispiel: ["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.

Fehlerbeispiele

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.

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Parameter

query

create_as_dashboard

Auf "true" setzen, um eine Dashboard-E-Mail zu erstellen, die in der Datenbank mit fester 2-Monats-Ablaufzeit gespeichert wird. Wenn weggelassen, wird eine zeitbasierte API-E-Mail im Speicher erstellt. Beide unterstützen custom_username.

Beispiel: true

⚠️ ⚠️ Dashboard-E-Mails kosten 15 Credits. Feste 2-Monats-Ablaufzeit (kein Zeitparameter). Free-Tier-Benutzer erhalten einen 403-Fehler. Lassen Sie diesen Parameter weg, um eine zeitbasierte API-E-Mail mit benutzerdefinierten Zeitoptionen zu erstellen.

query

custom_username

Beispiel: john.doe

⚠️ ⚠️ Muss 3-30 Zeichen lang sein. Darf nicht mit Sonderzeichen beginnen/enden. Muss über alle Ihre E-Mails hinweg eindeutig sein. Wenn bereits vergeben, gibt 409 Conflict zurück.

query

domain

Optionale benutzerdefinierte Domain für die E-Mail-Adresse. Wenn nicht angegeben, wird eine zufällige öffentliche Domain verwendet.

Beispiel: mail.yourdomain.com

⚠️ Muss eine verifizierte Domain in Ihrem Konto sein

Fehlerbeispiele

403

TIER_RESTRICTED

Premium-Funktion

Dashboard-E-Mail-Erstellung erfordert einen kostenpflichtigen Plan

402

INSUFFICIENT_CREDITS

Benötigt 15 Credits, um Dashboard-E-Mail zu erstellen

Diese Operation kostet 15 Credits

400

INVALID_USERNAME

Benutzername muss mindestens 3 Zeichen lang sein

Validierung des benutzerdefinierten Benutzernamens fehlgeschlagen. Muss 3-30 Zeichen mit nur gültigen Zeichen sein.

409

EMAIL_IN_USE

E-Mail-Adresse "[email protected]" wird bereits verwendet

Der benutzerdefinierte Benutzername ist bereits vergeben. Wählen Sie einen anderen Benutzernamen.

400

INVALID_TIME_PARAMETER

Ungültiger Zeitparameter

Zeit muss eines von sein: 10min, 1hour, 1day, permanent

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Fehlerbeispiele

401

UNAUTHORIZED

Ungültiger oder fehlender API-Schlüssel

API-Schlüssel ist erforderlich und muss gültig sein

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Fehlerbeispiele

401

UNAUTHORIZED

Ungültiger oder fehlender API-Schlüssel

API-Schlüssel ist erforderlich und muss gültig sein

Beispiel‑Request

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

Code‑Snippets

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);

Dokumentation

Fehlerbeispiele

401

UNAUTHORIZED

Ungültiger oder fehlender API-Schlüssel

API-Schlüssel ist erforderlich und muss gültig sein

Beispiel‑Request

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

Code‑Snippets

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);

Limit: 60 RPMAPI‑Hub

API testen

Temp Mail API – Dokumentation & Test‑Hub

Dokumentation lesen, Endpunkte testen und Code kopieren – alles auf einer Seite.

POST /api/v1/emails/create

Dokumentation

Parameter

Fehlerbeispiele

Beispiel‑Request

Code‑Snippets

Community-Chat

Temp Mail - Free Temporary Email Generator with Custom Domain Support