Tmailor Open API

Temp Mail API para sa Pagsubok at Awtomasyon

Gumawa ng mga pansamantalang email address na tumatanggap lamang ng mensahe mula sa iyong code at basahin ang mga papasok na mensahe bilang JSON. Nananatili ang bawat address sa iyong Tmailor account hanggang sa tanggalin mo ito, at ibinabalik ng API ang one-time code na makikita nito sa isang mensahe.

Huling na-update: October 2026

Magsimula nang libre Basahin ang API docs

Tingnan ang mga plano at limitasyon

REST at JSON
Mga SDK, CLI at MCP server
100 libreng mailbox bawat buwan
Pangtanggap lamang, 24-oras na mga mensahe

export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

# pip install tmailor-sdk
from tmailor import Client

with Client() as client:  # reads TMAILOR_API_KEY
    box = client.mailboxes.create()
    print(box.email)

    # trigger the email, then wait for it
    msg = box.wait_for_message(
        timeout=120, since=(box.created_at or 0) - 1)
    print(msg.subject, msg.otp(), msg.links())

// npm install tmailor
import { Client } from "tmailor";

const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);

// trigger the email, then wait for it
const msg = await box.waitForMessage({
  timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);

<?php // composer require tmailor/tmailor
use Tmailor\Client;

$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";

// trigger the email, then wait for it
$msg = $box->waitForMessage(
    timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp;

Gumawa ng address, hintayin ang email, basahin ang code.

Magbayad kada mailbox, hindi kada request

Ang paggawa lang ng address ang gumagamit ng iyong mailbox quota. Hindi kasama ang paglista ng mga address, pagtingin sa inbox, at pagbasa o pagtanggal ng mga mensahe. Walang daily o monthly request quota ang mga paid plan, may limitasyon lang sa rate kada minuto.

Halimbawa: ang OTP test na gumagawa ng isang address at 25 beses na tumitingin sa inbox ay isang mailbox lang ang ginagamit.

Mula sa API key hanggang inbox sa apat na hakbang

Gumawa ng API key
Mag-sign in sa API platform gamit ang iyong tmailor.com account o Google at gumawa ng key. Sa Free plan, idagdag din ang nag-iisang server IP address na tatawag sa API.
Gumawa ng address
Magpadala ng isang request para makakuha ng random na address sa isang shared domain, o pumili ng custom na pangalan sa domain na pag-aari mo at na-verify na.
Basahin ang mga mensahe
Ilista ang inbox at basahin ang bawat mensahe bilang JSON: sender, subject, text, nilinis na HTML, at ang one-time code at mga link na natagpuan ng API.
Itago o burahin
Walang expiry ang mga address. Buksan ang parehong inbox sa tmailor.com gamit ang reuse link nito, o burahin ang address kapag tapos na ang iyong test.

Para sa paulit-ulit na email workflow

Bigyan ng sariling inbox ang bawat test run sa halip na magbahagi ng isang totoong mailbox.

Mga test sa pag-sign up at OTP

Gumawa ng bagong address para sa bawat sign-up, password reset o pagsusuri ng one-time code, pagkatapos basahin ang code mula sa response.

Mga CI/CD pipeline

Magpatakbo ng end-to-end na pagsusuri ng email sa iyong pipeline gamit ang key sa isang environment variable. Tumatanggap ang mga bayad na plano ng mga kahilingan mula sa anumang IP address.

QA at staging

Bigyan ng sariling address ang mga tester at staging environment at panatilihing wala sa test data ang mga totoong inbox.

Mga address sa sarili mong domain

Magdagdag ng domain na pag-aari mo, ituro ang MX record nito sa amin at gumawa ng mga address na may custom na pangalan na sumusunod sa mga patakaran sa pagbibigay ng pangalan.

Mga plano at presyo

Piliin ang bilang ng mga mailbox na kailangan mo. Nagre-reset ang iyong allowance kada 30 araw, kahit sa taunang plano.

Libre

Subukan ang API at magpatakbo ng maliliit na proyekto.

$0 /buwan

100 mailbox tuwing 30 araw
Hanggang 30 request kada minuto
2,000 request kada araw
Mga tawag mula sa isang IP na nasa allowlist
Mga shared domain at sarili mong domain

Magsimula nang libre

Starter

Para sa isang developer o maliit na test suite.

$9 /buwan

3,000 mailbox tuwing 30 araw
Hanggang 300 request kada minuto
Walang quota sa request kada araw o kada buwan
Mga tawag mula sa anumang IP address
Mga shared domain at sarili mong domain

Piliin ang Starter

Pro

Para sa mga team na nagpapatakbo ng tests araw-araw.

$29 /buwan

30,000 mailbox tuwing 30 araw
Hanggang 600 request kada minuto
Walang quota sa request kada araw o kada buwan
Mga tawag mula sa anumang IP address
Mga shared domain at sarili mong domain

Piliin ang Pro

Business

Para sa mga kumpanyang may mabigat na awtomasyon araw-araw.

$99 /buwan

150,000 mailbox tuwing 30 araw
Hanggang 2,000 request kada minuto
Walang quota sa request kada araw o kada buwan
Mga tawag mula sa anumang IP address
Mga shared domain at sarili mong domain

Piliin ang Business

Scale

Para sa malalaking test fleet at abalang pipeline.

$199 /buwan

400,000 mailbox tuwing 30 araw
Hanggang 4,000 request kada minuto
Walang quota sa request kada araw o kada buwan
Mga tawag mula sa anumang IP address
Mga shared domain at sarili mong domain

Piliin ang Scale

Enterprise

Para sa pinakamataas na dami ng mailbox at pinakamataas na request rate.

$499 /buwan

2,000,000 mailbox tuwing 30 araw
Hanggang 6,000 request kada minuto
Walang quota sa request kada araw o kada buwan
Mga tawag mula sa anumang IP address
Mga shared domain at sarili mong domain

Piliin ang Enterprise

Ihambing ang mga plano

Nagbabago ang mga limitasyong ito depende sa plano. Pareho ang lahat ng iba pa sa bawat plano.

Ihambing ang mga plano
Plano	Libre	Starter	Pro	Business	Scale	Enterprise
Buwanang presyo	$0	$9	$29	$99	$199	$499
Taunang presyo	$0	$90	$290	$990	$1,990	$4,990
Mga mailbox kada 30 araw	100	3,000	30,000	150,000	400,000	2,000,000
Mga kahilingan kada minuto	30	300	600	2,000	4,000	6,000
Pang-araw-araw na limitasyon sa kahilingan	2,000	Walang limitasyon	Walang limitasyon	Walang limitasyon	Walang limitasyon	Walang limitasyon
IP allowlist	Kinakailangan, 1 IP	Hindi kailangan	Hindi kailangan	Hindi kailangan	Hindi kailangan	Hindi kailangan
Na-host na MCP server	Lokal na server lamang	Kasama	Kasama	Kasama	Kasama	Kasama

I-swipe nang pahalang upang ikumpara ang lahat ng plano.

Kasama sa bawat plano

REST API na may JSON responses
Mga random na address sa mga shared na domain
Mga custom na pangalan sa sarili mong verified na domain
Walang limitasyong sariling domain (hanggang 3 ang maaaring maghintay ng beripikasyon nang sabay-sabay)
Mga address na hindi nag-e-expire
Walang limitasyon sa dami ng address na itatago mo
Ang mga mensahe ay itinatago nang 24 na oras
Pagkuha ng one-time code at link (best effort)
Isang reuse link para buksan ang inbox sa tmailor.com
Mga opisyal na SDK at isang command-line tool
Maaaring pagsamahin ang mga plano at nagsasama-sama ang kanilang mga limitasyon
Tumatanggap lamang, walang mga attachment
Ang pagtanggal ng address ay hindi nagbabalik ng quota

Kapag naubos na ang mailbox allowance, hindi na makakagawa ng mga bagong address hanggang sa susunod na cycle o hanggang mag-upgrade. Patuloy pa ring gumagana ang mga umiiral na inbox.
Hindi na maibabalik ang mga bayad alinsunod sa API terms. Subukan muna ang iyong integration sa Free plan.

Opisyal na SDK at CLI

Tawagin ang API mula sa sarili mong wika gamit ang mga typed model, awtomatikong pag-retry, at helper na naghihintay sa susunod na mensahe. Pareho ang API na sinusunod ng bawat SDK at pareho rin ang mga shared test scenario.

Python

Available

Python 3.9+

pip install tmailor-sdk

Kasama ang tmailor command-line tool.

Tingnan sa PyPI Source sa GitHub

Node.js

Available

Node.js 18+, TypeScript types

npm install tmailor

Tingnan sa npm Source sa GitHub

PHP

Available

PHP 8.1+

composer require tmailor/tmailor

Tingnan sa Packagist Source sa GitHub

Para sa mga AI agent

MCP server para sa mga AI agent

Hayaang subukan ng Claude, Cursor, VS Code Copilot at iba pang MCP client ang mga sign-up flow na pag-aari mo o pinapayagan kang subukan: gumagawa ang agent ng tunay na receive-only address, naghihintay ng email at binabasa ang one-time code o verification link.

Parehong nagbibigay ang dalawang opsyon sa agent ng parehong mga tool: gumawa ng address, maghintay sa email at kunin ang one-time code at mga link nito, magbasa ng mga mensahe, magtanggal ng mga address at tingnan ang quota mo. Mga email address lang ang nakikita ng agent, hindi ang mga token sa likod ng mga ito, at ginagamit nito ang parehong mailbox quota at rate limit tulad ng API.

Naka-host na server

Walang kailangang i-install

https://mcp.tmailor.com/mcp

Idagdag ang server URL sa iyong AI app. Ang mga app na may sign-in, tulad ng Claude, ChatGPT at Codex, ay magdadala sa iyo sa Tmailor platform para aprubahan ang access. Ang ibang mga client ay nagpapadala ng iyong API key sa Authorization header.

Kailangan ng aktibong bayad na plano. Mula sa aming server ang mga tawag, kaya hindi mo kailangan ng IP allowlist.

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

Tingnan ang mga nakakonektang app sa pahina ng AI connections at idiskonekta ang alinman sa mga ito. Mawawalan ng access ang isang idiskonektang app sa loob ng 30 segundo.

Tingnan ang mga plano at limitasyon

Lokal na server

Lahat ng plano, kasama ang Free

tmailor-mcp

Tumatakbo ito sa computer mo, binabasa ang key mo mula sa TMAILOR_API_KEY at kailangan ng uv o Python 3.10+. Sa Free plan, idagdag sa allowlist ang IP ng computer na iyon.

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

Tingnan sa PyPI Setup para sa bawat MCP client

Subukang itanong: "Gumawa ng temp email, mag-sign up sa staging site ko gamit ito at sabihin sa akin ang verification code."

FAQ sa Temp mail API

Ano ang itinuturing na isang mailbox?

Bawat bagong address na gagawin mo ay gumagamit ng isang mailbox mula sa allotment ng kasalukuyang 30-araw na siklo. Ang paglilista, pagbabasa at pagtanggal ay hindi gumagamit ng mailbox, at ang pagtanggal ng address ay hindi nagsasauli ng mailbox.

Nag-e-expire ba ang mga address?

Hindi. Nananatili ang isang address sa iyong account hanggang sa tanggalin mo ito. Ang mga mensahe dito ay itinatago nang 24 na oras.

Maaari ba akong magpadala ng email o makatanggap ng mga attachment?

Hindi. Ang API ay para sa pagtanggap lamang at hindi ipinapadala ang mga attachment.

Maaari ko bang piliin ang pangalan at domain ng address?

Sa aming mga shared domain, random ang pangalan. Para pumili ng pangalan, magdagdag at mag-verify ng domain na pag-aari mo sa API platform sa pamamagitan ng pagturo ng MX record nito sa amin, pagkatapos ay gumawa ng mga address na may custom na pangalan na sumusunod sa mga patakaran sa pagbibigay ng pangalan.

Kailangan ko ba ng IP allowlist?

Sa Free plan lang, kung saan idinadagdag mo ang isang IP address na pinanggagalingan ng tawag ng server mo. Ang isang IP address ay maaaring maging kabilang lamang sa isang Free account, kaya maaaring may gumagamit na ng shared office o VPN address. Sa aktibong bayad na plano, tumatanggap ang API ng mga kahilingan mula sa anumang IP address.

Binabasa ba ng API ang verification code para sa akin?

Oo, sa abot ng makakaya. Kapag binasa mo ang isang mensahe, kasama sa tugon ang one-time code na natagpuan nito (o null kapag hindi ito sigurado), iba pang code-like na halaga at ang mga link. Palaging suriin ang halaga sa iyong pagsubok.

Maaari bang gamitin ng mga AI agent tulad ng Claude o ChatGPT ang API?

Oo, sa pamamagitan ng MCP. Sa bayad na plano, idagdag ang hosted server na https://mcp.tmailor.com/mcp sa iyong AI app at aprubahan ang access, o ipadala ang iyong API key. Sa anumang plano, maaari mong patakbuhin ang open-source na tmailor-mcp server sa sarili mong computer. Sa alinmang paraan, makakagawa ang agent ng address, maghihintay ng email at babasahin ang one-time code, gamit ang parehong mailbox quota tulad ng API.

May limitasyon ba sa request sa mga bayad na plano?

Walang daily o monthly request quota ang mga bayad na plano, ngunit bawat plano ay may limitasyon sa rate kada minuto. Ang Free plan ay may daily request cap din.

Kailangan ko ba ng credit card para magsimula?

Hindi. Mag-sign in gamit ang iyong tmailor.com account o Google, gumawa ng key at magsimula sa Free plan. Magbabayad ka lang kapag pumili ka ng bayad na plano.

Paano ako magbabayad para sa isang plano?

Magbayad gamit ang USDT sa TRC20 (Tron) o BEP20 (BNB Smart Chain) network, o gamit ang Binance Pay. Hindi tinatanggap ang mga credit at debit card. Magiging aktibo ang iyong plano kapag nakumpirma ang bayad, kadalasan sa loob ng ilang minuto.

Maaari ba akong makakuha ng refund?

Hindi. Hindi refundable ang mga bayad, kaya subukan ang iyong integration sa Free plan bago mag-upgrade.

Ano ang hindi pinapayagang gamitin sa API?

Ang spam, pandaraya, maramihang paggawa ng account sa ibang serbisyo, at pag-iwas sa kanilang mga ban o limitasyon ay lumalabag sa mga tuntunin ng API. Maaari naming bawiin ang API keys ng mga account na gumagawa nito at i-lock ang mga ito.

Gumawa ng iyong unang address sa ilang minuto

Magsimula sa Free plan na may 100 mailbox bawat buwan. Walang kailangang credit card.

Magsimula nang libre Basahin ang API docs

Temp Mail API para sa Pagsubok at Awtomasyon

Magbayad kada mailbox, hindi kada request

Mula sa API key hanggang inbox sa apat na hakbang

Gumawa ng API key

Gumawa ng address

Basahin ang mga mensahe

Itago o burahin

Para sa paulit-ulit na email workflow

Mga test sa pag-sign up at OTP

Mga CI/CD pipeline

QA at staging

Mga address sa sarili mong domain

Mga plano at presyo

Libre

Starter

Pro

Business

Scale

Enterprise

Ihambing ang mga plano

Kasama sa bawat plano

Opisyal na SDK at CLI

Python

Node.js

PHP

MCP server para sa mga AI agent

Naka-host na server

Lokal na server

FAQ sa Temp mail API

Gumawa ng iyong unang address sa ilang minuto