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 হল ডেভেলপারদের জন্য ইমেইল ইনফ্রাস্ট্রাকচার, যেখানে একটি ইউনিফাইড REST API রয়েছে temporary email ঠিকানা তৈরি, আসল ইমেইল গ্রহণ এবং WebSocket বা সাইনড Webhook-এর মাধ্যমে রিয়েল-টাইম নতুন মেসেজ পাঠানোর জন্য। API শুরু করতে ফ্রি — যেকোনো HTTP client-এর সাথে সামঞ্জস্যপূর্ণ। Selenium, Cypress, Playwright, Puppeteer টেস্ট, CI/CD pipeline বা আপনার নিজের backend থেকে সরাসরি কল করুন।

ওয়ার্কফ্লো

একটি মেইলবক্স তৈরি করুন, SMTP-এর মাধ্যমে বাস্তব ইমেইল গ্রহণ করুন এবং REST API দিয়ে মেসেজ পড়ুন। মেইলবক্স ৭ দিন পর স্বয়ংক্রিয়ভাবে মেয়াদ শেষ হয়।

# 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 টাইপড response এবং 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 অটোমেশন এবং ডেভেলপারদের অস্থায়ী ব্যবহারের জন্য ডিজাইন করা হয়েছে — দীর্ঘমেয়াদী মেইলবক্স হিসেবে নয়।