Referensi API

Kode error

Semua kode error yang bisa dikembalikan API, dengan status HTTP dan cara menanganinya. Send dan Receive memakai format error yang berbeda.

Kirim email

Error mengembalikan objek JSON dengan error, code, dan responseTime. Lihat Kirim email.

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

  • 403SHARED_DOMAIN_REQUIRES_PAID_PLAN

    Domain pengiriman bersama ini hanya tersedia di paket berbayar. Respons mencantumkan domain bersama yang bisa Anda pakai di allowedDomains, beserta upgradeUrl. Gunakan salah satunya atau domain terverifikasi Anda sendiri.

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

Batas paket gratis

Di paket gratis, email marketing dan cold outreach dibatasi 30 email per hari, dihitung per penerima (satu email ke 5 orang dihitung 5) dalam jendela bergulir 24 jam. Email transaksional tidak terpengaruh. Di atas batas, permintaan ditolak dan tidak ada yang diantrekan: kirim lagi saat jendela terbuka, atau upgrade.

403MARKETING_LIMIT_REACHED

Dikembalikan oleh /v3.0/send jika email ini akan melewati batas marketing paket gratis. used adalah jumlah yang sudah dihitung dalam 24 jam terakhir dan recipients adalah jumlah yang akan ditambahkan email ini.

{
  "code": "MARKETING_LIMIT_REACHED",
  "error": "Daily marketing limit reached for the free plan (30/30, 2 recipients in this email). Transactional emails still go out.",
  "limit": 30,
  "used": 30,
  "recipients": 2,
  "upgradeUrl": "https://app.sendcorex.com/dashboard/billing"
}
403SHARED_DOMAIN_REQUIRES_PAID_PLAN

Dikembalikan saat Anda membuat pengirim di domain bersama yang hanya tersedia di paket berbayar. allowedDomains mencantumkan domain bersama yang bisa dipakai paket Anda; domain terverifikasi Anda sendiri selalu bisa dipakai.

{
  "code": "SHARED_DOMAIN_REQUIRES_PAID_PLAN",
  "error": "This shared domain is available on paid plans. Use inboxtaken.com or your own domain.",
  "allowedDomains": ["inboxtaken.com"],
  "upgradeUrl": "https://app.sendcorex.com/dashboard/billing"
}

Aturan lengkap: Kebijakan Penggunaan yang Dapat Diterima — Paket gratis

Receive: error HTTP

Error ini menolak seluruh request. Body-nya adalah { "type": "ERROR", "code": "...", "message": "..." }. Saat RATE_LIMITED, tunggu selama detik yang tertera di header Retry-After.

  • 400INVALID_JSON

    The body is not {"commands":[...]} or has more than 20 commands.

  • 401MISSING_AUTH_HEADER

    No Authorization header was sent.

  • 401INVALID_TOKEN

    The token is malformed, unknown or revoked.

  • 401TOKEN_EXPIRED

    The access token has expired. Call Refresh Token and repeat the request.

  • 401INVALID_REFRESH_TOKEN

    The refresh token is invalid, expired, revoked or already used. Generate a new token in the dashboard.

  • 429RATE_LIMITED

    More than 15 requests/s or 15 in flight for the same IP + mailbox. Wait the number of seconds in Retry-After.

  • 503AUTH_UNAVAILABLE

    Authentication is temporarily unavailable. Try again.

Receive: error perintah

Error ini kembali di dalam hasil perintah, dengan HTTP 200, sehingga satu perintah yang gagal tidak menghentikan perintah lain di request yang sama. Periksa results[].type. Lihat Jalankan perintah.

  • CMDINVALID_ARGS

    A required argument is missing or invalid.

  • CMDUNKNOWN_COMMAND

    The command name does not exist.

  • CMDNOT_FOUND

    The message, thread or folder does not exist for this token.

  • CMDINVALID_CURSOR

    The cursor is malformed or belongs to another account or folder.

  • CMDALREADY_EXISTS

    A folder or label with this name already exists.

  • CMDNOT_IN_TRASH

    delete only works on messages in Trash or Spam. Use move to send a message to Trash first.

  • CMDSENDER_NOT_FOUND

    The sender behind the token is not registered.

  • CMDSENDER_NO_DOMAIN

    The sender behind the token has no domain.

  • CMDNO_CREDITS

    The account has fewer email credits than recipients (1 credit per copy).

  • CMDNO_RECIPIENT

    The conversation has no recipient to reply to.

  • CMDINVALID_RULE

    The rule is not valid. The message says which condition or action and why.

  • CMDLIMIT

    The mailbox reached the limit (100 rules, 200 templates or 100 labels).

  • CMDINVALID_TOADDRESS

    The to address is not a valid email.

  • CMDINVALID_CCADDRESS

    One of the cc addresses is not a valid email.

  • CMDINVALID_BCCADDRESS

    One of the bcc addresses is not a valid email.

  • CMDINVALID_RECIPIENT

    The recipient is missing or not a valid email.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc and bcc together have more than 50 addresses.

  • CMDINVALID_ATTACHMENT

    An attachment content is not valid base64.

  • CMDFILE_BLOCKED

    A file was blocked by the security scan.

  • CMDATTACHMENTS_TOO_LARGE

    The attachments of the email add up to more than 25 MB, or the mailbox already has 500 MB of uploads waiting to be sent.

  • CMDTOO_MANY_OPEN_COMPOSES

    The mailbox has 50 emails with uploads that were not sent yet. Send them, or wait for the unused ones to be deleted after 48 hours.

  • CMDATTACHMENT_MISSING

    An uploaded attachment no longer exists (uploads not sent within 48 hours, and not used by a draft or scheduled email, are deleted). Upload it again.

  • CMDALREADY_SENT

    The compose_uid belongs to an email that was already sent.

  • CMDINVALID_TIME

    send_at is missing, less than 1 minute away or more than 1 year away.

  • CMDMISSING_SUBJECT

    A new email needs a subject.

  • CMDMISSING_TARGET

    Reply and forward need the original email, and it must still exist.

  • CMDDRAFT_NOT_FOUND

    The draft does not exist anymore: it was sent, deleted, or saved again (every save returns a new draft_id).

  • CMDNOT_SCHEDULED

    The email was already sent or canceled.

  • CMDSEND_FAILED

    The send was refused. The email is back in Drafts and the message says why.

  • CMDNO_UNSUBSCRIBE

    The email has no List-Unsubscribe header.

  • CMDRECIPIENT_UNSUBSCRIBED

    One or more recipients unsubscribed from this mailbox. `recipients` lists them: remove them or send again with `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    More than one address in `to` needs a paid plan.

  • CMDTOO_MANY_RECIPIENTS

    `to` has more than 30 addresses.

  • CMDINVALID_AUDIENCE

    The audience is not valid: unknown group, a segment of another mailbox or a message this mailbox didn’t send.

  • CMDAUDIENCE_OVER_LIMIT

    The audience has more people than you can send to (up to 5,000 per email and your daily limit). `total` and `allowed` say how many.

  • CMDEMPTY_AUDIENCE

    Nobody in this audience right now.

  • CMDBEST_TIME_NEEDS_AUDIENCE

    `best_time` needs an `audience` and `mode: new`.

  • CMDREAD_ONLY_ACCESS

    The token or app has Read only access and the command writes. In the attachment upload route it is HTTP 403.

  • CMDINTERNAL

    Server error. The detail is only written to the server log.