Email

Jadwalkan Email

Gunakan endpoint pengiriman yang sama dengan parameter scheduled_at untuk menunda pengiriman. Menerima tanggal ISO 8601 atau bahasa alami. Email tetap bisa dibatalkan hingga dikirim.

POSThttps://mail.sendcorex.com/v3.0/send
i

Simpan id yang dikembalikan. Anda memerlukannya untukmembatalkan email sebelum dikirim.

Parameter tambahan

  • scheduled_atstringopsionalbaru

    Kapan email dikirim. Menerima format ISO 8601 atau bahasa alami. Harus di masa mendatang.

    mis. "in 1 hour" · "tomorrow at 9am" · "2026-08-05T11:52:01Z"

Semua parameter lain sama dengan Kirim Email.

Bahasa alami

Format apa pun berikut ini bisa digunakan untuk scheduled_at.

  • "in 1 hour"
  • "in 30 minutes"
  • "tomorrow at 9am"
  • "Friday at 3pm ET"
  • "next Monday at 8am"
  • "2026-08-05T11:52:01Z"

Mulai cepat

import axios from 'axios';

const response = await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Your weekly digest',
    body: '<p>Here is what happened this week...</p>',
    scheduled_at: 'tomorrow at 9am',
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

// Save the id: you need it to cancel the email before it is sent
const { id, ids, scheduledAt, recipients } = response.data;
console.log('Scheduled for ' + scheduledAt + ' (id: ' + id + ')');

Respons

{
  "success": true,
  "message": "Email scheduled successfully",
  "code": "EMAIL_SCHEDULED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "ids": [
    { "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
  ],
  "scheduledAt": "2026-04-26T09:00:00.000Z",
  "recipients": 1
}

Error mengembalikan objek JSON dengan error dan code.

  • 401MISSING_AUTH_HEADER

    Tidak ada header Authorization.

  • 401INVALID_API_KEY

    API key tidak valid atau sudah dicabut.

  • 401ACCOUNT_BLOCKED

    Akun telah diblokir.

  • 401NO_CREDITS_LEFT

    Kredit email tidak cukup untuk semua penerima. Setiap alamat di to, cc, dan bcc memakai 1 kredit.

  • 401DOMAIN_NOT_VALIDATED

    Domain pengirim belum diverifikasi.

  • 401LISTED_SPAM_HAUS

    Domain pengirim terdaftar di Spamhaus.

  • 401ISP_DOMAIN_BLOCKED

    Mengirim dari domain umum (gmail.com, outlook.com, dll.) tidak diizinkan.

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domain header From tidak diizinkan untuk pengirim ini.

  • 401USER_NOT_FOUND

    Pengguna tidak ditemukan.

  • 401MISSING_USER_PRIVILEGES

    Hak akses pengguna tidak cukup.

  • 401EMAIL_CREDITS_NOT_FOUND

    Gagal mengambil kredit email.

  • 401EMAIL_NOT_VALIDATED

    Alamat email akun belum diverifikasi.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API key diblokir sementara karena pelanggaran kebijakan berulang.

  • 429IP_TEMPORARILY_BLOCKED

    IP peminta diblokir sementara karena pelanggaran kebijakan berulang.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Terlalu banyak request bersamaan dari IP ini. Coba lagi sebentar lagi.

  • 400INVALID_JSON

    Body request bukan JSON yang valid.

  • 400MISSING_FROM

    Field from tidak ada atau kosong.

  • 400INVALID_FROM_FORMAT

    Field from harus berupa alamat email yang valid.

  • 400MISSING_SENDERNAME

    Field senderName tidak ada atau kosong.

  • 400INVALID_SENDERNAME_FORMAT

    Field senderName berisi karakter yang tidak valid.

  • 400MISSING_SUBJECT

    Field subject tidak ada atau kosong.

  • 400MISSING_BODY

    Field body tidak ada atau kosong.

  • 400MISSING_TOADDRESS

    Field to tidak ada atau kosong.

  • 400MISSING_TO

    Field to tidak ada atau kosong.

  • 400INVALID_TOADDRESS

    Satu atau lebih alamat penerima tidak valid.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Lebih dari 50 penerima di array to.

  • 400INVALID_CCADDRESS

    Satu atau lebih alamat cc tidak valid.

  • 400INVALID_BCCADDRESS

    Satu atau lebih alamat bcc tidak valid.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc, dan bcc jika digabung memiliki lebih dari 50 penerima unik.

  • 400INVALID_SCHEDULED_AT

    scheduled_at bukan tanggal yang valid atau sudah lewat.

  • 400INVALID_SENDER_FORMAT

    Format email pengirim tidak valid.

  • 400HEADER_NOT_ALLOWED

    Kunci header kustom tidak ada di daftar yang diizinkan (List-Unsubscribe, List-Id, X-*, dll.).

  • 400INVALID_HEADER_VALUE

    Nilai header berisi karakter tidak valid (CR/LF tidak diizinkan).

  • 400DANGEROUS_ATTACHMENT

    Satu atau lebih lampiran diblokir demi keamanan.

  • 400INVALID_ATTACHMENT

    Konten lampiran bukan base64 yang valid.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe bernilai true tetapi body tidak memiliki placeholder berhenti berlangganan ([unsubscribe_url], [unsubscribe], [unsub_url], atau [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    Akun dibatasi sementara.

  • 403DAILY_LIMIT

    Batas harian pengiriman email tercapai.

  • 403MARKETING_LIMIT_REACHED

    Batas harian email marketing paket gratis tercapai: 30 email marketing atau cold outreach per hari, dihitung per penerima dalam jendela bergulir 24 jam. Respons berisi limit, used, recipients, dan upgradeUrl. Email transaksional tetap terkirim; tidak ada yang diantrekan.

  • 403FORBIDDEN_HTML_CONTENT

    HTML berisi konten aktif yang tidak diizinkan di email (script, iframe, form, input, button, embed, object, svg, handler on*, link javascript:, meta refresh…). Respons mencantumkan temuannya. Gunakan <a> yang diberi gaya sebagai pengganti tombol atau formulir.

  • 403SPAM_DETECTED

    Konten email ditandai sebagai spam. Respons menyertakan quarantine_id dan petunjuk rilis.

  • 403SENDER_NAME_MISMATCH

    Terdeteksi beberapa nama pengirim untuk alamat yang sama.

  • 403FOLLOWUP_PATTERN_DETECTED

    Konten email ditandai sebagai pola tindak lanjut mencurigakan yang berulang.

  • 403SCAM_PATTERN_DETECTED

    Konten email ditandai sebagai pola penipuan.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Akun ditangguhkan karena berulang kali mencoba memalsukan header From.

  • 409IDEMPOTENCY_IN_PROGRESS

    Permintaan dengan Idempotency-Key yang sama masih diproses. Tunggu (Retry-After: 1) lalu ulangi dengan kunci yang sama.

  • 422IDEMPOTENCY_KEY_REUSED

    Idempotency-Key ini sudah dipakai dengan body yang berbeda. Gunakan kunci baru untuk setiap email baru.

  • 500INTERNAL_SERVER_ERROR

    Error server tak terduga. Coba lagi.

  • 500PARSE_ERROR

    Gagal memproses konten email (gagal parse MIME).

  • 500PERSIST_FAILED

    Gagal memasukkan email ke antrean (gagal menyimpan ke database).

  • 503AUTH_UNAVAILABLE

    API key tidak dapat divalidasi saat ini. Coba lagi.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Layanan tautan berhenti berlangganan sementara tidak tersedia. Coba lagi nanti.