Email

Header Kustom

Tambahkan header kustom ke email keluar Anda menggunakan objek headers pada permintaan pengiriman.

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

Aturan penamaan:header apa pun di luar daftar yang dicadangkan di bawah harus diawali dengan X-. Aturan ini diterapkan untuk mencegah header injection dan melindungi field yang dicadangkan oleh RFC.

Header yang dicadangkan

Header ini tidak memerlukan prefiks X-. Untuk header berhenti berlangganan, lihatHeader Berhenti Berlangganan.

  • List-Id

    Mengidentifikasi mailing list tempat email ini berada.

  • X-Report-Abuse

    URL tempat penerima bisa melaporkan penyalahgunaan.

  • Feedback-ID

    Pengenal yang digunakan penyedia mailbox untuk mengelompokkan laporan feedback loop.

  • List-Unsubscribe

    Metode berhenti berlangganan (mailto: dan/atau https:).

  • List-Unsubscribe-Post

    Mengaktifkan berhenti berlangganan sekali klik.

Header lainnya

Harus diawali dengan X-. Selain itu akan ditolak sebelum email masuk antrean.

Valid

  • "X-MyCustomHeader": "testcustom0"
  • "X-CUSTOM-X": "testcustom1"

Tidak valid

  • "MyCustomHeader": "testcustom0"
  • → HEADER_NOT_ALLOWED

Mulai cepat

import axios from 'axios';

await axios.post(
  'https://mail.sendcorex.com/v3.0/send',
  {
    to: 'user@example.com',
    from: 'noreply@yourdomain.com',
    senderName: 'My App',
    subject: 'Welcome aboard!',
    body: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
    replyTo: 'support@yourdomain.com',
    headers: {
      'List-Id': 'My List <mylist.yourdomain.com>',
      'X-Report-Abuse': 'https://yourdomain.com/report-abuse',
      'Feedback-ID': 'campaign123:subscriber456:list789:youraccount',
      'List-Unsubscribe':
        '<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
      'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
      'X-MyCustomHeader': 'testcustom0',
      'X-CUSTOM-X': 'testcustom1',
    },
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);

Respons

{
  "success": true,
  "message": "Email queued successfully",
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}

Error mengembalikan objek JSON dengan error, code, dan responseTime.

  • 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.