How do I get started with the Mail.td API?

Authenticate with a Pro API Token (Bearer td_...) or start with the free plan. Call POST /api/accounts to create a temp mail address, then use GET /api/accounts/{id}/messages to retrieve received emails. Full API reference at docs.mail.td.

What SDKs are available?

Mail.td provides official SDKs for Node.js/TypeScript (npm install mailtd), Python (pip install mailtd), and Go (go get github.com/mailtd/mailtd-go). Each SDK fully covers the REST API with typed responses and error handling.

Can I receive emails in real time?

Yes. You can subscribe via WebSocket for push notifications or register a Webhook endpoint to receive HTTP POST callbacks with HMAC-SHA256 signatures when new emails arrive.

How long are emails retained?

All emails are automatically deleted after 7 days on both Free and Pro plans. Attachments and raw .eml files are also permanently removed after expiration.

अस्थायी ईमेल API

डेवलपर्स के लिए एकीकृत REST API: temp mail पते बनाएं, वास्तविक ईमेल प्राप्त करें।

API दस्तावेज़ देखें

Mail.td डेवलपर्स के लिए ईमेल बुनियादी ढांचा है, जिसमें temporary email पते बनाने, वास्तविक ईमेल प्राप्त करने और WebSocket या signed Webhook के माध्यम से नए संदेशों को वास्तविक समय में पहुंचाने के लिए एक एकीकृत REST API है। API शुरू करने के लिए मुफ़्त है — किसी भी HTTP client के साथ संगत। इसे Selenium, Cypress, Playwright, Puppeteer टेस्ट, CI/CD pipeline या अपने स्वयं के backend से सीधे कॉल करें।

वर्कफ़्लो

एक मेलबॉक्स बनाएं, SMTP के माध्यम से असली ईमेल प्राप्त करें, और REST API के माध्यम से संदेश पढ़ें। मेलबॉक्स 7 दिन बाद स्वचालित रूप से समाप्त हो जाते हैं।

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK और Client लाइब्रेरियां

Mail.td तीन भाषाओं में आधिकारिक SDK प्रदान करता है। प्रत्येक client typed responses और error handling के साथ REST API को पूर्ण रूप से कवर करता है — इंस्टॉल करें, अपने Pro API Token से प्रमाणीकरण करें, और उपयोग शुरू करें।

Node.js / TypeScript

npm install mailtd

Native fetch का उपयोग करने वाला zero-dependency client, पूर्ण TypeScript type definitions के साथ।

Python

pip install mailtd

HTTP-आधारित client, dataclass types और async context manager समर्थन के साथ।

Go

go get github.com/mailtd/mailtd-go

केवल stdlib, context-आधारित request lifecycle, पूरी तरह से typed struct।

महत्वपूर्ण नोट्स Pro योजना के ईमेल 7 दिनों तक रखे जाते हैं, फिर स्वचालित रूप से हटा दिए जाते हैं (मुफ़्त योजना की रिटेंशन अवधि के लिए मूल्य पृष्ठ देखें)। Mail.td को ईमेल परीक्षण, QA स्वचालन और डेवलपरों के अस्थायी उपयोग के लिए डिज़ाइन किया गया है — दीर्घकालिक mailbox के रूप में नहीं।