ईमेल भेजें

अवलोकन

अकाउंट → डोमेन → आपका डोमेन → API में DNS सत्यापन पूरा होने के बाद कुंजियाँ जनरेट करें। पूर्ण सीक्रेट केवल एक बार दिखाया जाता है — इसे सुरक्षित रखें। उसी डोमेन पैनल में वैकल्पिक SMTP क्रेडेंशियल्स समान केवल-लेन-देन नियमों का पालन करते हैं।

केवल लेन-देन संबंधी मेल

Unbox HTTP API (POST /api/v1/email) and optional SMTP submission are for transactional mail only — messages tied to an account action, purchase, or operational event. They are not a newsletter or marketing broadcast service.

अनुमत उपयोग

• खाता सत्यापन, पासवर्ड रीसेट और सुरक्षा अलर्ट
• ऑर्डर पुष्टिकरण, रसीदें, शिपिंग अपडेट और भुगतान सूचनाएँ
• किसी विशिष्ट उपयोगकर्ता या सिस्टम घटना द्वारा ट्रिगर की गई सूचनाएँ
• टीम और वर्कस्पेस संदेश (आमंत्रण, असाइनमेंट, आंतरिक अलर्ट)

निषिद्ध उपयोग

• न्यूज़लेटर, प्रचार अभियान या प्रसारण विपणन
• कोल्ड आउटरीच या खरीदी गई, स्क्रैप की गई या सहमति न देने वाली सूचियों पर मेल
• एफिलिएट स्पैम, फ़िशिंग या भ्रामक सामग्री
• प्राप्तकर्ता सीमा, दर सीमा या योजना कोटा को बायपास करने का कोई भी प्रयास

दर और प्राप्तकर्ता सीमाएँ

प्राप्तकर्ताओं और डिलीवरेबिलिटी की सुरक्षा के लिए, आउटबाउंड API और SMTP ट्रैफ़िक नीचे दी गई सीमाओं के अधीन है (आपकी योजना की मासिक आउटबाउंड कोटा के अतिरिक्त)। प्रवर्तन वेब कंपोज़र, HTTP API और SMTP सबमिशन पर सक्रिय है। वेब कंपोज़र प्रति संदेश 25 प्राप्तकर्ताओं के बाद चेतावनी देता है और 50 से अधिक भेजने को रोकता है।

ये नियम हमारी स्वीकार्य उपयोग नीति का हिस्सा हैं। स्वचालित प्रवर्तन वेब कंपोज़र, HTTP API और SMTP सबमिशन पर सक्रिय है। जो खाते विपणन या बल्क मेल भेजते हैं, या अन्यथा भेजने के बुनियादी ढांचे का दुरुपयोग करते हैं, उन्हें थ्रॉटल, निलंबित या समाप्त किया जा सकता है।

हम डिलीवरेबिलिटी सिग्नल की निगरानी करते हैं। 3% से अधिक लगातार बाउंस दर या 0.1% से अधिक शिकायत दर अस्थायी भेजने पर रोक या मैन्युअल समीक्षा को ट्रिगर कर सकती है।

पूर्ण नीति विवरण के लिए हमारा सेवा की शर्तें, गोपनीयता नीति और GDPR वक्तव्य देखें।

प्रमाणीकरण

हर अनुरोध पर अपनी डोमेन API कुंजी भेजें:

Authorization: Bearer ubk_live_xxxxxxxxxxxxxxxxxxxxxxxx

वैकल्पिक रूप से, X-Api-Key: ubk_live_… का उपयोग करें। कुंजियाँ हैश करके संग्रहीत की जाती हैं; डोमेन डैशबोर्ड से रिवोक या रोटेट करें।

अनुरोध बॉडी

PascalCase फ़ील्ड नामों (From, To, …) के साथ JSON। camelCase उपनाम भी स्वीकार किए जाते हैं।

उदाहरण

{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}

सफलता प्रतिक्रिया

HTTP 200 JSON के साथ:

{
  "ErrorCode": 0,
  "Message": "OK",
  "MessageID": "0100018…-000000-…",
  "SubmittedAt": "2026-06-23T12:00:00.000Z",
  "To": "user@example.com"
}

त्रुटि प्रतिक्रियाएँ

त्रुटियाँ 4xx (या अप्रत्याशित विफलताओं के लिए 500) JSON के साथ लौटाती हैं:

{
  "ErrorCode": 300,
  "Message": "TextBody or HtmlBody is required."
}

उदाहरण

you@yourdomain.com को डोमेन पर अपने व्यक्तिगत मेलबॉक्स से बदलें और अपनी API कुंजी का उपयोग करें।

curl "https://api.unbox.im/api/v1/email" \
  -H "Authorization: Bearer ubk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}'

LLM

Use this page as the source of truth when calling the send API from an agent.

• POST https://api.unbox.im/api/v1/email only. Do not invent other send paths.
• Authorization: Bearer ubk_live_… (or X-Api-Key). One key per verified custom domain.
• Transactional mail only — receipts, alerts, password resets. Not newsletters or marketing bulk.
• Required: From, To, Subject, and TextBody or HtmlBody. From must be a mailbox on the key's domain.
• Errors are JSON with ErrorCode and Message. Do not retry 401/403/300 without fixing the request.