Tmailor اوپن API

ٹیسٹنگ اور آٹومیشن کے لیے ٹیمپ میل API

اپنے کوڈ سے صرف وصول کرنے والے عارضی ای میل ایڈریس بنائیں اور آنے والے پیغامات JSON کے طور پر پڑھیں۔ ہر ایڈریس آپ کے Tmailor اکاؤنٹ میں اس وقت تک رہتا ہے جب تک آپ اسے حذف نہ کریں، اور API پیغام میں ملنے والا ون ٹائم کوڈ واپس کرتا ہے۔

آخری بار اپ ڈیٹ: October 2026

مفت شروع کریں API دستاویزات پڑھیں

پلانز اور حدود دیکھیں

REST اور JSON
SDKs، CLI اور MCP سرور
ہر ماہ 100 مفت میل باکسز
صرف وصولی، 24 گھنٹے تک پیغامات

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;

ایک ایڈریس بنائیں، ای میل کا انتظار کریں، کوڈ پڑھیں۔

میل باکس کے حساب سے ادائیگی، درخواست کے حساب سے نہیں

صرف ایڈریس بنانے پر آپ کا میل باکس کوٹہ استعمال ہوتا ہے۔ ایڈریسز کی فہرست دیکھنا، ان باکس چیک کرنا اور پیغامات پڑھنا یا حذف کرنا اس میں شمار نہیں ہوتا۔ ادائیگی شدہ پلانز میں روزانہ یا ماہانہ درخواست کوٹہ نہیں ہوتا، صرف فی منٹ کی شرح کی حد ہوتی ہے۔

مثال: ایک OTP ٹیسٹ جو ایک ایڈریس بناتا ہے اور ان باکس 25 بار چیک کرتا ہے، صرف ایک میل باکس استعمال کرتا ہے۔

API کی سے ان باکس تک چار مراحل میں

API کی بنائیں
اپنے tmailor.com اکاؤنٹ یا Google سے API پلیٹ فارم میں سائن اِن کریں اور ایک key بنائیں۔ Free پلان میں، وہ واحد سرور IP ایڈریس بھی شامل کریں جو API کو کال کرے گا۔
ایک ایڈریس بنائیں
ایک درخواست بھیج کر مشترکہ ڈومین پر کوئی بے ترتیب ایڈریس حاصل کریں، یا اپنے ملکیت والے اور تصدیق شدہ ڈومین پر اپنی پسند کا نام منتخب کریں۔
پیغامات پڑھیں
ان باکس کی فہرست حاصل کریں اور ہر پیغام کو JSON کے طور پر پڑھیں: بھیجنے والا، موضوع، متن، صاف شدہ HTML، اور API کی جانب سے تلاش کردہ ون ٹائم کوڈ اور لنکس۔
اسے رکھیں یا حذف کریں
ایڈریسز کی میعاد ختم نہیں ہوتی۔ اسی ان باکس کو tmailor.com پر اس کے ری یوز لنک سے کھولیں، یا اپنا ٹیسٹ مکمل ہونے پر ایڈریس حذف کر دیں۔

بار بار دہرائے جانے والے ای میل ورک فلو کے لیے بنایا گیا

ایک حقیقی میل باکس شیئر کرنے کے بجائے ہر ٹیسٹ رن کو اس کا اپنا ان باکس دیں۔

سائن اپ اور OTP ٹیسٹ

ہر سائن اپ، پاس ورڈ ری سیٹ یا ایک بار استعمال ہونے والے کوڈ کی جانچ کے لیے نیا پتہ بنائیں، پھر جواب سے کوڈ پڑھیں۔

CI/CD پائپ لائنز

اپنی پائپ لائن میں API کلید کو ماحولیاتی متغیر میں رکھ کر اینڈ ٹو اینڈ ای میل جانچیں۔ ادائیگی شدہ پلانز کسی بھی IP ایڈریس سے درخواستیں قبول کرتے ہیں۔

QA اور اسٹیجنگ

ٹیسٹرز اور اسٹیجنگ ماحول کو ان کے اپنے پتے دیں اور اصل ان باکسز کو ٹیسٹ ڈیٹا سے دور رکھیں۔

آپ کے اپنے ڈومین پر پتے

ایک ڈومین جو آپ کے پاس ہے شامل کریں، اس کا MX ریکارڈ ہماری طرف اشارہ کریں اور نام رکھنے کے قواعد کے مطابق حسبِ ضرورت ناموں کے ساتھ پتے بنائیں۔

پلانز اور قیمتیں

جتنے میل باکسز درکار ہوں منتخب کریں۔ آپ کا کوٹہ ہر 30 دن بعد ری سیٹ ہوتا ہے، سالانہ پلانز پر بھی۔

مفت

API آزمائیں اور چھوٹے پروجیکٹس چلائیں۔

$0 /ماہ

ہر 30 دن میں 100 میل باکسز
فی منٹ زیادہ سے زیادہ 30 درخواستیں
روزانہ 2,000 درخواستیں
ایک اجازت یافتہ IP سے کالز
مشترکہ ڈومینز اور آپ کے اپنے ڈومینز

مفت شروع کریں

Starter

ایک ڈویلپر یا چھوٹے ٹیسٹ سوٹ کے لیے۔

$9 /ماہ

ہر 30 دن میں 3,000 میل باکسز
فی منٹ زیادہ سے زیادہ 300 درخواستیں
روزانہ یا ماہانہ درخواستوں کی کوئی حد نہیں
کسی بھی IP ایڈریس سے کالز
مشترکہ ڈومینز اور آپ کے اپنے ڈومینز

Starter منتخب کریں

Pro

ان ٹیموں کے لیے جو روزانہ ٹیسٹ چلاتی ہیں۔

$29 /ماہ

ہر 30 دن میں 30,000 میل باکسز
فی منٹ زیادہ سے زیادہ 600 درخواستیں
روزانہ یا ماہانہ درخواستوں کی کوئی حد نہیں
کسی بھی IP ایڈریس سے کالز
مشترکہ ڈومینز اور آپ کے اپنے ڈومینز

Pro منتخب کریں

Business

ان کمپنیوں کے لیے جن کی روزانہ آٹومیشن بہت زیادہ ہوتی ہے۔

$99 /ماہ

ہر 30 دن میں 150,000 میل باکسز
فی منٹ زیادہ سے زیادہ 2,000 درخواستیں
روزانہ یا ماہانہ درخواستوں کی کوئی حد نہیں
کسی بھی IP ایڈریس سے کالز
مشترکہ ڈومینز اور آپ کے اپنے ڈومینز

Business منتخب کریں

Scale

بڑے ٹیسٹ فلیٹس اور مصروف پائپ لائنز کے لیے۔

$199 /ماہ

ہر 30 دن میں 400,000 میل باکسز
فی منٹ زیادہ سے زیادہ 4,000 درخواستیں
روزانہ یا ماہانہ درخواستوں کی کوئی حد نہیں
کسی بھی IP ایڈریس سے کالز
مشترکہ ڈومینز اور آپ کے اپنے ڈومینز

Scale منتخب کریں

Enterprise

سب سے زیادہ میل باکس والیوم اور درخواست کی شرح کے لیے۔

$499 /ماہ

ہر 30 دن میں 2,000,000 میل باکسز
فی منٹ زیادہ سے زیادہ 6,000 درخواستیں
روزانہ یا ماہانہ درخواستوں کی کوئی حد نہیں
کسی بھی IP ایڈریس سے کالز
مشترکہ ڈومینز اور آپ کے اپنے ڈومینز

Enterprise منتخب کریں

پلانز کا موازنہ

یہ حدود ہر پلان میں مختلف ہوتی ہیں۔ باقی سب کچھ ہر پلان میں یکساں ہے۔

پلانز کا موازنہ
پلان	مفت	Starter	Pro	Business	Scale	Enterprise
ماہانہ قیمت	$0	$9	$29	$99	$199	$499
سالانہ قیمت	$0	$90	$290	$990	$1,990	$4,990
ہر 30 دن میں میل باکسز	100	3,000	30,000	150,000	400,000	2,000,000
فی منٹ درخواستیں	30	300	600	2,000	4,000	6,000
روزانہ درخواستوں کی حد	2,000	کوئی حد نہیں	کوئی حد نہیں	کوئی حد نہیں	کوئی حد نہیں	کوئی حد نہیں
IP allowlist	لازمی، 1 IP	ضرورت نہیں	ضرورت نہیں	ضرورت نہیں	ضرورت نہیں	ضرورت نہیں
ہوسٹڈ MCP سرور	صرف مقامی سرور	شامل	شامل	شامل	شامل	شامل

تمام پلانز کا موازنہ کرنے کے لیے سائیڈ کی طرف سوائپ کریں۔

ہر پلان میں شامل

JSON جوابات کے ساتھ REST API
مشترکہ ڈومینز پر بے ترتیب پتے
اپنے تصدیق شدہ ڈومینز پر حسبِ ضرورت نام
لامحدود اپنے ڈومینز (ایک وقت میں 3 تک تصدیق کا انتظار کر سکتے ہیں)
ایسے پتے جو ختم نہیں ہوتے
آپ کتنے پتے رکھتے ہیں اس کی کوئی حد نہیں
پیغامات 24 گھنٹے تک محفوظ رہتے ہیں
ایک وقتی کوڈ اور لنک نکالنا (بہترین کوشش)
tmailor.com پر ان باکس کھولنے کے لیے دوبارہ استعمال کا لنک
سرکاری SDKs اور کمانڈ لائن ٹول
پلانز کو ملایا جا سکتا ہے اور ان کی حدیں جمع ہو جاتی ہیں
صرف وصولی، اٹیچمنٹ کے بغیر
پتہ حذف کرنے سے کوٹا واپس نہیں ملتا

جب میل باکس الاؤنس ختم ہو جائے تو اگلے سائیکل یا اپ گریڈ تک نئے ایڈریس نہیں بنائے جا سکتے۔ موجودہ ان باکسز کام کرتے رہتے ہیں۔
API کی شرائط کے تحت ادائیگیاں ناقابلِ واپسی ہیں۔ پہلے اپنی انٹیگریشن فری پلان پر آزمائیں۔

سرکاری SDKs اور CLI

ٹائپ شدہ ماڈلز، خودکار ری ٹرائیز اور اگلے پیغام کا انتظار کرنے والے ہیلپر کے ساتھ اپنی زبان سے API کال کریں۔ ہر SDK ایک ہی API اور مشترکہ ٹیسٹ سیناریوز کی پیروی کرتا ہے۔

Python

دستیاب

Python 3.9+

pip install tmailor-sdk

اس میں tmailor کمانڈ لائن ٹول شامل ہے۔

PyPI پر دیکھیں GitHub پر سورس

Node.js

دستیاب

Node.js 18+, TypeScript types

npm install tmailor

npm پر دیکھیں GitHub پر سورس

PHP

دستیاب

PHP 8.1+

composer require tmailor/tmailor

Packagist پر دیکھیں GitHub پر سورس

AI ایجنٹس کے لیے

AI ایجنٹس کے لیے MCP سرور

Claude، Cursor، VS Code Copilot اور دیگر MCP کلائنٹس کو اپنے یا جنہیں جانچنے کی اجازت حاصل ہو ایسے سائن اپ فلو کی جانچ کرنے دیں: ایجنٹ ایک حقیقی، صرف وصول کرنے والا ایڈریس بناتا ہے، ای میل کا انتظار کرتا ہے اور ون ٹائم کوڈ یا تصدیقی لنک پڑھتا ہے۔

دونوں آپشنز ایجنٹ کو ایک ہی ٹولز دیتے ہیں: ایڈریس بنانا، ای میل کا انتظار کرنا اور اس کا ون ٹائم کوڈ اور لنکس حاصل کرنا، پیغامات پڑھنا، ایڈریسز حذف کرنا اور اپنا کوٹا چیک کرنا۔ ایجنٹ صرف ای میل ایڈریسز دیکھتا ہے، ان کے پیچھے موجود ٹوکنز کبھی نہیں، اور یہ وہی میل باکس کوٹا اور ریٹ لمٹ استعمال کرتا ہے جو API استعمال کرتی ہے۔

ہوسٹڈ سرور

انسٹال کرنے کی ضرورت نہیں

https://mcp.tmailor.com/mcp

سرور URL کو اپنی AI ایپ میں شامل کریں۔ سائن ان کی سہولت والی ایپس، جیسے Claude، ChatGPT اور Codex، رسائی کی منظوری کے لیے آپ کو Tmailor پلیٹ فارم پر بھیجتی ہیں۔ دیگر کلائنٹس آپ کی API key کو Authorization ہیڈر میں بھیجتے ہیں۔

فعال ادائیگی شدہ پلان درکار ہے۔ کالز ہمارے سرور سے آتی ہیں، اس لیے آپ کو 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_..."}}}}

AI connections صفحے پر منسلک ایپس دیکھیں اور ان میں سے کوئی بھی منقطع کریں۔ منقطع شدہ ایپ 30 سیکنڈ کے اندر رسائی کھو دیتی ہے۔

پلانز اور حدود دیکھیں

مقامی سرور

ہر پلان، بشمول مفت

tmailor-mcp

یہ آپ کے کمپیوٹر پر چلتا ہے، آپ کی کی TMAILOR_API_KEY سے پڑھتا ہے اور اس کے لیے uv یا Python 3.10+ درکار ہے۔ فری پلان میں، اس کمپیوٹر کا IP allowlist میں شامل کریں۔

# 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

PyPI پر دیکھیں ہر MCP کلائنٹ کے لیے سیٹ اپ

یہ پوچھ کر دیکھیں: "ایک عارضی ای میل بنائیں، اس سے میری اسٹیجنگ سائٹ پر سائن اپ کریں اور مجھے تصدیقی کوڈ بتائیں۔"

عارضی میل API کے اکثر پوچھے گئے سوالات

میل باکس کس چیز کے طور پر شمار ہوتا ہے؟

آپ جو بھی نیا پتہ بناتے ہیں وہ موجودہ 30 دن کے دورانیے کے کوٹے میں سے ایک میل باکس استعمال کرتا ہے۔ فہرست دیکھنا، پڑھنا اور حذف کرنا میل باکس استعمال نہیں کرتے، اور پتہ حذف کرنے سے میل باکس واپس نہیں ملتا۔

کیا پتے ختم ہو جاتے ہیں؟

نہیں۔ پتہ آپ کے اکاؤنٹ میں تب تک رہتا ہے جب تک آپ اسے حذف نہ کریں۔ اس میں موجود پیغامات 24 گھنٹے تک محفوظ رہتے ہیں۔

کیا میں ای میل بھیج سکتا ہوں یا اٹیچمنٹ وصول کر سکتا ہوں؟

نہیں۔ API صرف وصول کرنے کے لیے ہے اور اٹیچمنٹس فراہم نہیں کیے جاتے۔

کیا میں پتے کا نام اور ڈومین منتخب کر سکتا ہوں؟

ہمارے مشترکہ ڈومینز پر نام بے ترتیب ہوتا ہے۔ نام منتخب کرنے کے لیے، API پلیٹ فارم پر اپنا ڈومین شامل کریں اور اس کا MX ریکارڈ ہماری طرف اشارہ کر کے تصدیق کریں، پھر نام رکھنے کے قواعد کے مطابق حسبِ منشا نام کے ساتھ پتے بنائیں۔

کیا مجھے IP allowlist کی ضرورت ہے؟

صرف فری پلان پر، جہاں آپ وہ واحد IP ایڈریس شامل کرتے ہیں جس سے آپ کا سرور کال کرتا ہے۔ ایک IP ایڈریس صرف ایک فری اکاؤنٹ کا ہو سکتا ہے، اس لیے مشترکہ دفتری یا VPN ایڈریس پہلے سے استعمال میں ہو سکتا ہے۔ فعال ادائیگی شدہ پلان کے ساتھ، API کسی بھی IP ایڈریس سے درخواستیں قبول کرتا ہے۔

کیا API میرے لیے تصدیقی کوڈ پڑھ لیتا ہے؟

جی ہاں، بہترین کوشش کی بنیاد پر۔ جب آپ کوئی پیغام پڑھتے ہیں تو جواب میں وہ ایک بار کا کوڈ شامل ہوتا ہے جو اسے ملا (یا جب یقین نہ ہو تو null)، دیگر کوڈ نما ویلیوز اور لنکس بھی شامل ہوتے ہیں۔ اپنے ٹیسٹ میں ہمیشہ ویلیو کی جانچ کریں۔

کیا Claude یا ChatGPT جیسے AI ایجنٹس API استعمال کر سکتے ہیں؟

جی ہاں، MCP کے ذریعے۔ ادائیگی شدہ پلان پر، ہوسٹڈ سرور https://mcp.tmailor.com/mcp کو اپنی AI ایپ میں شامل کریں اور رسائی کی منظوری دیں، یا اپنی API key بھیجیں۔ کسی بھی پلان پر، آپ اوپن سورس tmailor-mcp سرور اپنے کمپیوٹر پر چلا سکتے ہیں۔ دونوں صورتوں میں، ایجنٹ ایک پتہ بنا سکتا ہے، ای میل کا انتظار کر سکتا ہے اور ایک بار کا کوڈ پڑھ سکتا ہے، اور وہ API والا ہی میل باکس کوٹہ استعمال کرتا ہے۔

کیا ادائیگی شدہ پلانز پر درخواستوں کی کوئی حد ہے؟

ادائیگی شدہ پلانز پر روزانہ یا ماہانہ درخواستوں کا کوٹہ نہیں ہوتا، لیکن ہر پلان کی فی منٹ ریٹ حد ہوتی ہے۔ فری پلان پر روزانہ درخواستوں کی حد بھی ہے۔

کیا شروع کرنے کے لیے کریڈٹ کارڈ کی ضرورت ہے؟

نہیں۔ اپنے tmailor.com اکاؤنٹ یا Google سے سائن ان کریں، ایک key بنائیں اور فری پلان پر شروع کریں۔ آپ ادائیگی صرف اس وقت کرتے ہیں جب آپ ادائیگی شدہ پلان منتخب کرتے ہیں۔

میں پلان کی ادائیگی کیسے کر سکتا ہوں؟

USDT کے ذریعے TRC20 (Tron) یا BEP20 (BNB Smart Chain) نیٹ ورک پر، یا Binance Pay کے ذریعے ادائیگی کریں۔ کریڈٹ اور ڈیبٹ کارڈز قبول نہیں کیے جاتے۔ آپ کا پلان ادائیگی کی تصدیق ہونے پر فعال ہو جاتا ہے، عام طور پر چند منٹوں میں۔

کیا مجھے رقم واپس مل سکتی ہے؟

نہیں۔ ادائیگیاں ناقابلِ واپسی ہیں، اس لیے اپ گریڈ کرنے سے پہلے اپنی انٹیگریشن فری پلان پر ٹیسٹ کریں۔

API کس چیز کے لیے استعمال کرنے کی اجازت نہیں ہے؟

اسپیم، فراڈ، دیگر سروسز پر بڑی تعداد میں اکاؤنٹس بنانا، اور ان کی پابندیوں یا حدود سے بچنا API کی شرائط کی خلاف ورزی ہے۔ ہم ایسا کرنے والے اکاؤنٹس کی API keys منسوخ کر سکتے ہیں اور انہیں لاک کر سکتے ہیں۔

اپنا پہلا پتہ منٹوں میں بنائیں

ماہانہ 100 میل باکسز کے ساتھ فری پلان پر شروع کریں۔ کریڈٹ کارڈ کی ضرورت نہیں۔

مفت شروع کریں API دستاویزات پڑھیں

ٹیسٹنگ اور آٹومیشن کے لیے ٹیمپ میل API

میل باکس کے حساب سے ادائیگی، درخواست کے حساب سے نہیں

API کی سے ان باکس تک چار مراحل میں

API کی بنائیں

ایک ایڈریس بنائیں

پیغامات پڑھیں

اسے رکھیں یا حذف کریں

بار بار دہرائے جانے والے ای میل ورک فلو کے لیے بنایا گیا

سائن اپ اور OTP ٹیسٹ

CI/CD پائپ لائنز

QA اور اسٹیجنگ

آپ کے اپنے ڈومین پر پتے

پلانز اور قیمتیں

مفت

Starter

Pro

Business

Scale

Enterprise

پلانز کا موازنہ

ہر پلان میں شامل

سرکاری SDKs اور CLI

Python

Node.js

PHP

AI ایجنٹس کے لیے MCP سرور

ہوسٹڈ سرور

مقامی سرور

عارضی میل API کے اکثر پوچھے گئے سوالات

اپنا پہلا پتہ منٹوں میں بنائیں