API заавар

Имэйл илгээх

Нэг эсвэл олон хаяг руу текст, HTML имэйл илгээнэ.

POST/v1/email

Нэг хаяг руу илгээнэ. Имэйл дараалалд орж, хариу 202-оор шууд буцна.

Биеийн талбарууд

tostringзаавал: Хүлээн авагчийн имэйл хаяг.
subjectstringзаавал: Гарчиг. 255 тэмдэгт хүртэл, нэг мөр.
htmlstring: HTML агуулга. html, text-ийн аль нэг заавал байна.
textstring: Энгийн текст агуулга. Хоёуланг өгвөл HTML харуулж чадахгүй програмд текст нь харагдана.
from_namestring: Илгээгчийн нэр. Өгөөгүй бол төслийн брэндийн нэр, эсвэл төслийн нэр.
reply_tostring: Хариу очих хаяг. Өгөөгүй бол төслийн тохиргоонд заасан хаяг.

curl -X POST https://api.wesend.mn/v1/email \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "[email protected]",
  "subject": "Таны захиалга баталгаажлаа",
  "html": "<h1>Баярлалаа!</h1><p>Таны #1042 захиалга баталгаажлаа.</p>",
  "text": "Баярлалаа! Таны #1042 захиалга баталгаажлаа.",
  "from_name": "Shop.mn",
  "reply_to": "[email protected]"
}'

Хариу202 Accepted

{
  "id": "0b9c1a52-6f0e-4d8b-9a3c-2f1e5d7c8a90",
  "status": "queued",
  "channel": "email",
  "to": "[email protected]",
  "credits": 5,
  "batch_id": null,
  "error": null,
  "created_at": "2026-10-06T08:15:30.000Z",
  "sent_at": null,
  "balance": 4995
}

Имэйлүүд WeSend-ийн дундын домэйноос илгээгдэнэ. Илгээгчийн нэр болон хариу авах хаягийг та тохируулна.
html болон text-ийн нийт хэмжээ 256 KB-аас хэтрэхгүй. Хэтэрвэл 422 message_too_long.
Эцсийн төлөвийг GET /messages/{id}-ээр шалгана: sent эсвэл failed. Илгээгдээгүй бол кредит буцна.

Олон хаяг руу илгээх

POST/v1/email/bulk

Нэг имэйлийг 1,000 хүртэл хаяг руу илгээнэ. Хүлээн авагч бүр тусдаа имэйл авах тул бие биенийхээ хаягийг харахгүй.

Талбарууд /email-тэй адил, зөвхөн to нь хаягуудын жагсаалт байна.

curl -X POST https://api.wesend.mn/v1/email/bulk \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "[email protected]",
    "[email protected]"
  ],
  "subject": "Шинэ бараа ирлээ",
  "html": "<p>Намрын цуглуулга худалдаанд гарлаа.</p>"
}'

Хариу202 Accepted

{
  "id": "5d2a7c1e-93b4-4f6a-8e0d-b1c2d3e4f5a6",
  "status": "processing",
  "channel": "email",
  "total": 2,
  "sent": 0,
  "failed": 0,
  "credits": 10,
  "created_at": "2026-10-06T08:15:30.000Z",
  "completed_at": null,
  "balance": 4985
}