Need to generate dozens or hundreds of temp mail addresses at once? Manual clicking is too slow. This guide shows how to bulk create inboxes with YYDS Mail API.
Bulk Generation Use Cases
- Batch registration testing: testing registration flows with many emails
- Data collection: some platforms require email registration to view content
- Load testing: simulating concurrent users
- Automation workflows: CI/CD pipelines creating test accounts
JavaScript Bulk Creation
const API_BASE = "https://maliapi.215.im/v1";
const API_KEY = process.env.YYDS_API_KEY;
async function createBatchEmails(count) {
const accounts = [];
for (let i = 0; i < count; i++) {
const res = await fetch(`${API_BASE}/accounts`, {
method: "POST",
headers: { "X-API-Key": API_KEY },
});
const { data } = await res.json();
accounts.push(data);
await new Promise((r) => setTimeout(r, 200)); // avoid rate limit
}
return accounts;
}
const emails = await createBatchEmails(50);
emails.forEach((acc) => console.log(acc.address));
Python Example
import requests, time
API_BASE = "https://maliapi.215.im/v1"
API_KEY = "AC-your-key-here"
def create_batch(count):
accounts = []
for i in range(count):
res = requests.post(f"{API_BASE}/accounts", headers={"X-API-Key": API_KEY})
accounts.append(res.json()["data"])
time.sleep(0.2)
return accounts
Use Webhook Instead of Polling
For batch scenarios, polling is inefficient. Configure Webhooks to get notified when each inbox receives mail. See Webhook guide.
Important Notes
- Rate limits: add delays (200ms+) between requests
- Quota: each create/query counts — paid plans have more
- Concurrency: don't send too many parallel requests (avoid 429)
- Error handling: implement retries
- Cleanup: delete temp accounts after use
FAQ
How many can I create at once? Depends on quota. Free tier has daily limits, paid has more. Batch in groups of 50-100.
Will bulk creation get me banned? Normal API usage won't. But abusive mass registration may violate terms.
How long do bulk-created addresses last? Free: during session. Paid: long-term. See pricing.
Want bulk temp mail? See full API docs, or read API getting started.
