Send Email - Notiblast

Mengirim satu email. Response 201 berarti pesan diantrekan, bukan sudah sampai — status akhirnya dipantau lewat log pesan.

Kirim dengan template: kirim to + template: { id, variables } tanpa html/text. from/subject/reply_to dari request menang atas nilai template. Domain from hasil gabungan tetap wajib terdaftar & verified. Replay Idempotency-Key tidak membaca template.

Kuota email bulanan (plan.limits.email_monthly_quota, 0 = unlimited, satuan per send): bila email yang sudah terkirim bulan ini ≥ kuota ⇒ 402 Monthly email quota exceeded + data: { quota, used }, dan satu baris log berstatus failed_quota maks. 1×/menit per company. Yang dihitung hanya email yang benar-benar keluar (diterima Postfix, atau ditolak karena alamat salah X.1.x); gagal sisi server tidak dihitung. SMTP menjawab 550 5.7.1.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢201Success

application/json

Email queued, atau All recipients are suppressed bila semua penerima ada di daftar suppression (data.status = suppressed, tidak ada email yang dikirim).

Bodyapplication/json

🟠404Template tidak ditemukan

🟠422Template belum dipublikasi

🟠422Variabel template tidak valid

🟠422Hasil render tidak valid

🟠402Kuota email bulanan habis

🟢200Replay Idempotency-Key

🟠400Validasi body gagal

🟠400Request tidak valid

🟠401API key tidak valid

🟠402Langganan tidak aktif

🟠403Akun disuspend

🟠403Domain belum terverifikasi

🟠403API key tidak berhak atas domain

🟠403Trial sudah dipakai domain ini

🟠403Trial dijeda

🟠404Domain tidak ditemukan

🟠429Rate limit rute

🟠429Rate limit paket

🔴500Gagal mengantrekan

curl --location 'https://primaryapi.notiblast.com/v1/emails/send' \ --header 'Idempotency-Key: order-1042-receipt' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "from": "Toko Kita <noreply@updates.example.com>", "to": [ "budi@gmail.com" ], "subject": "Invoice #1042", "html": "<p>Terima kasih atas pesanan Anda.</p>", "reply_to": "cs@updates.example.com" }'

{ "request_id": "string", "message": "Email queued", "data": { "_id": "507f1f77bcf86cd799439071", "company": "507f1f77bcf86cd799439011", "domain": "507f1f77bcf86cd799439051", "api_key": "507f1f77bcf86cd799439061", "from": "Toko Kita <noreply@updates.example.com>", "to": [ "budi@gmail.com" ], "suppressed_to": [], "subject": "Invoice #1042", "status": "queued", "error": null, "postfix_queue_id": null, "idempotency_key": null, "sent_at": null, "bounced_at": null, "expires_at": "2026-08-20T04:20:00.000Z", "created_at": "2026-08-06T04:20:00.000Z", "updated_at": "2026-08-06T04:20:00.000Z" } }