Mailtr Developer API

Tạo hộp thư dùng-một-lần (chỉ nhận) bằng code: nhận email, đọc thư, lấy mã OTP tự trích sẵn, và đẩy qua webhook. Dành cho kiểm thử tự động (QA/CI), automation và AI agent.

Xác thực bằng header X-API-Key. Base URL: https://mailtr.vn. Tạo key trong Tài khoản → API.

Endpoints

Bắt đầu nhanh

# 1) Tạo inbox
curl -s https://mailtr.vn/api/v1/inbox -X POST \
  -H "X-API-Key: $MAILTR_KEY" -H "content-type: application/json" -d '{}'
# -> { "ok": true, "id": "...", "address": "abc@..." }

# 2) Lấy danh sách thư
curl -s https://mailtr.vn/api/v1/inbox/$INBOX_ID/messages -H "X-API-Key: $MAILTR_KEY"

# 3) Đọc thư + OTP tự trích
curl -s https://mailtr.vn/api/v1/messages/$MSG_ID -H "X-API-Key: $MAILTR_KEY"
# -> { "message": { "otp": "246810", "text": "...", "html": "..." } }

SDK · CLI · MCP

• SDK @mail1h/sdk: new Mail1h({ apiKey }).waitForOtp(inboxId) — tự chờ & lấy OTP.
• CLI @mail1h/cli: MAILTR_KEY=… mail1h otp <inboxId>
• MCP @mail1h/mcp: server cho AI agent (Claude, Codex…) tự lấy mã xác thực.
• OpenAPI: /openapi.json

Webhooks

Đăng ký URL để nhận POST mỗi khi có thư tới. Mỗi request được ký X-Mail1h-Signature = HMAC-SHA256(secret, body). Payload: { event, message_id, inbox_id, to, from, subject, otp, received_at }

Bảng giá (theo tháng)

Mua/gia hạn/nâng cấp tự động qua chuyển khoản — nâng cấp được bù trừ thời gian còn lại. Rẻ hơn dịch vụ quốc tế ~10 lần.

Hướng dẫn & bài viết

Tích hợp Mailtr API vào Python, Playwright, n8n và hơn thế.