BoomlifyBoomlify
Chrome Web Store

Temp Mail API Documentation & Testing Hub

Read the docs, test endpoints, and copy code — all on a single page.

Base URL:
https://pleasehelpustogrow.onrender.com

POST /api/v1/emails/create

Create a new temporary email address

Auth RequiredRate Limited

Documentation

Parameters

query
time
Expiration time
Example: permanent
⚠️ Must be one of: 10min, 1hour, 1day, permanent
query
domain
Custom domain (must be verified)
Example: mail.yourdomain.com
⚠️ Must be a verified custom domain

Error Examples

429
DAILY_LIMIT_EXCEEDED
Daily limit exceeded for 1hour emails
You have reached your daily limit for this email type
400
INVALID_DOMAIN
Custom domain mail.yourdomain.com not found or not verified
Domain must be verified in your dashboard first
400
INVALID_TIME_PARAMETER
Time must be one of: 10min, 1hour, 1day, permanent
Invalid time parameter provided

Example Request

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

Code Snippets

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

const data = await response.json();
API Hub
Test API