एक पत्र भेजें

API 0.16.0OpenAPIllms-full.txt

POST/v1/mailboxes/{mailbox_id}/send

आवश्यक Idempotency-Key 8-128 अक्षर। एक ही कुंजी और बॉडी के साथ दोहराने से वही ऑपरेशन वापस आता है; दूसरा निकाय 409 देता है। HTTP 202 का अर्थ है कतार में लगना। ऑपरेशन की स्थिति की जाँच करें, न कि इस तथ्य की कि कोई प्रतिक्रिया प्राप्त हुई थी।

प्राधिकरण और पहुंच क्षेत्र · त्रुटियाँ और दोहराव

अनुरोध

curl -X POST 'https://adapt-mail.com/v1/mailboxes/<mailbox_id>/send' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Idempotency-Key: message-20261019-0001' \
  -H 'Content-Type: application/json' \
  --data '{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}'

विकल्प

mailbox_idpathअनिवार्य रूप से

integer

X-Customer-IDheader

विकल्प 1

string

विकल्प 2

null

Idempotency-Keyheaderअनिवार्य रूप से

string

minLength: 8

maxLength: 128

निकाय से अनुरोध करें · application/json

object

toअनिवार्य रूप से

array

मुख्य प्राप्तकर्ताओं के पते.

minItems: 1

maxItems: 50

सरणी तत्व

string

cc

array

अन्य प्रतिभागियों को दिखाई देने वाले प्राप्तकर्ता पते की प्रतिलिपि बनाएँ।

maxItems: 50

सरणी तत्व

string

bcc

array

प्राप्तकर्ता पते की गुप्त प्रतिलिपि.

maxItems: 50

सरणी तत्व

string

subject

string

पत्र का विषय.

गलती करना: ""

maxLength: 998

text

string

बिना फ़ॉर्मेट किए पत्र का पाठ.

गलती करना: ""

maxLength: 200000

html

पत्र का HTML-स्वरूपित संस्करण।

विकल्प 1

string

maxLength: 300000

विकल्प 2

null

file_ids

array

इस मेलबॉक्स में ID पहले डाउनलोड की गई फ़ाइलें। डाउनलोड करते समय या फ़ाइलों की सूची से उन्हें प्राप्त करें।

maxItems: 20

सरणी तत्व

string · uuid

forward_message

मूल ईमेल जिसके अनुलग्नकों को अग्रेषित करने की आवश्यकता है।

विकल्प 1

object

folderअनिवार्य रूप से

string

फ़ोल्डर सूची से फ़ोल्डर का नाम, उदाहरण के लिए INBOX.

minLength: 1

maxLength: 255

uidvalidityअनिवार्य रूप से

integer

इस फ़ोल्डर के लिए प्रतिक्रिया API से मान uidvalidity है।

exclusiveMinimum: 0

uidअनिवार्य रूप से

integer

exclusiveMinimum: 0

अज्ञात फ़ील्ड स्वीकार नहीं किए जाते.

विकल्प 2

null

reply_to_message_id

आप जिस ईमेल का उत्तर दे रहे हैं उसका message_id मान।

विकल्प 1

string

maxLength: 998

विकल्प 2

null

references

उत्तर श्रृंखला को सहेजने के लिए मूल संदेश का मान references है।

विकल्प 1

string

maxLength: 4000

विकल्प 2

null

send_at

समय क्षेत्र के साथ विलंबित प्रेषण समय, उदाहरण के लिए 2026-11-01T12:00:00Z. मूल्य के बिना, कतार संसाधित होते ही प्रेषण शुरू हो जाता है।

विकल्प 1

string · date-time

विकल्प 2

null

अज्ञात फ़ील्ड स्वीकार नहीं किए जाते.

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

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

application/json

object

id

string · uuid

स्थिति की जांच करने और लंबित सबमिशन को रद्द करने के लिए ऑपरेशन आईडी।

kind

string

mailbox_id

विकल्प 1

integer

विकल्प 2

null

status

string

मान्य मान: "queued" "running" "succeeded" "failed" "uncertain" "cancelled"

run_at

string

UTC. में दिनांक और समय यदि कोई ऑफसेट नहीं है, तो मान UTC. का भी प्रतिनिधित्व करता है

created_at

string

UTC. में दिनांक और समय यदि कोई ऑफसेट नहीं है, तो मान UTC. का भी प्रतिनिधित्व करता है

completed_at

विकल्प 1

string

UTC. में दिनांक और समय यदि कोई ऑफसेट नहीं है, तो मान UTC. का भी प्रतिनिधित्व करता है

विकल्प 2

null

error

यदि ऑपरेशन सफलतापूर्वक पूरा नहीं हुआ तो त्रुटि का कारण।

विकल्प 1

string

विकल्प 2

null

result

ऑपरेशन का नतीजा. भेजने के लिए, स्वीकृत और अस्वीकृत प्राप्तकर्ताओं के बारे में जानकारी शामिल है।

विकल्प 1

object

विकल्प 2

null

400 अमान्य शीर्षलेख या पहचानकर्ता

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

401 लॉगिन आवश्यक है

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

403 तक पहुँच नहीं

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

404 संसाधन नहीं मिला

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

409 राज्य संघर्ष

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

413 आकार से अधिक हो गया

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

422 सत्यापन त्रुटि

application/json

object

detail

array

सरणी तत्व

object

locअनिवार्य रूप से

array

सरणी तत्व

विकल्प 1

string

विकल्प 2

integer

msgअनिवार्य रूप से

string

typeअनिवार्य रूप से

string

503 अस्थायी अनुपलब्धता

application/json

object

detail

विकल्प 1

string

विकल्प 2

object

code

string

message

string

विकल्प 3

array

सरणी तत्व

object

सफल प्रस्तुतिकरण परिणाम

ऑपरेशन के result फ़ील्ड निष्पादन के बाद हैं, कतारबद्ध होने की प्रतिक्रिया नहीं।

object

message_id

string

smtp_accepted

boolean

sent_saved

boolean

accepted_recipients

array

सरणी तत्व

string

rejected_recipients

array

सरणी तत्व

object

email

string

code

integer