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.
- 401
MISSING_AUTH_HEADERTidak ada header Authorization.
- 401
INVALID_API_KEYAPI key tidak valid atau sudah dicabut.
- 401
ACCOUNT_BLOCKEDAkun telah diblokir.
- 401
NO_CREDITS_LEFTKredit email tidak cukup untuk semua penerima. Setiap alamat di to, cc, dan bcc memakai 1 kredit.
- 401
DOMAIN_NOT_VALIDATEDDomain pengirim belum diverifikasi.
- 401
LISTED_SPAM_HAUSDomain pengirim terdaftar di Spamhaus.
- 401
ISP_DOMAIN_BLOCKEDMengirim dari domain umum (gmail.com, outlook.com, dll.) tidak diizinkan.
- 401
FROM_HEADER_DOMAIN_MISMATCHDomain header From tidak diizinkan untuk pengirim ini.
- 401
USER_NOT_FOUNDPengguna tidak ditemukan.
- 401
MISSING_USER_PRIVILEGESHak akses pengguna tidak cukup.
- 401
EMAIL_CREDITS_NOT_FOUNDGagal mengambil kredit email.
- 401
EMAIL_NOT_VALIDATEDAlamat email akun belum diverifikasi.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI key diblokir sementara karena pelanggaran kebijakan berulang.
- 429
IP_TEMPORARILY_BLOCKEDIP peminta diblokir sementara karena pelanggaran kebijakan berulang.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSTerlalu banyak request bersamaan dari IP ini. Coba lagi sebentar lagi.
- 400
INVALID_JSONBody request bukan JSON yang valid.
- 400
MISSING_FROMField from tidak ada atau kosong.
- 400
INVALID_FROM_FORMATField from harus berupa alamat email yang valid.
- 400
MISSING_SENDERNAMEField senderName tidak ada atau kosong.
- 400
INVALID_SENDERNAME_FORMATField senderName berisi karakter yang tidak valid.
- 400
MISSING_SUBJECTField subject tidak ada atau kosong.
- 400
MISSING_BODYField body tidak ada atau kosong.
- 400
MISSING_TOADDRESSField to tidak ada atau kosong.
- 400
MISSING_TOField to tidak ada atau kosong.
- 400
INVALID_TOADDRESSSatu atau lebih alamat penerima tidak valid.
- 400
TOADDRESS_LIMIT_EXCEEDEDLebih dari 50 penerima di array to.
- 400
INVALID_CCADDRESSSatu atau lebih alamat cc tidak valid.
- 400
INVALID_BCCADDRESSSatu atau lebih alamat bcc tidak valid.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc, dan bcc jika digabung memiliki lebih dari 50 penerima unik.
- 400
INVALID_SCHEDULED_ATscheduled_at bukan tanggal yang valid atau sudah lewat.
- 400
INVALID_SENDER_FORMATFormat email pengirim tidak valid.
- 400
HEADER_NOT_ALLOWEDKunci header kustom tidak ada di daftar yang diizinkan (List-Unsubscribe, List-Id, X-*, dll.).
- 400
INVALID_HEADER_VALUENilai header berisi karakter tidak valid (CR/LF tidak diizinkan).
- 400
DANGEROUS_ATTACHMENTSatu atau lebih lampiran diblokir demi keamanan.
- 400
INVALID_ATTACHMENTKonten lampiran bukan base64 yang valid.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe bernilai true tetapi body tidak memiliki placeholder berhenti berlangganan ([unsubscribe_url], [unsubscribe], [unsub_url], atau [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDAkun dibatasi sementara.
- 403
DAILY_LIMITBatas harian pengiriman email tercapai.
- 403
MARKETING_LIMIT_REACHEDBatas 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.
- 403
FORBIDDEN_HTML_CONTENTHTML 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.
- 403
SPAM_DETECTEDKonten email ditandai sebagai spam. Respons menyertakan quarantine_id dan petunjuk rilis.
- 403
SENDER_NAME_MISMATCHTerdeteksi beberapa nama pengirim untuk alamat yang sama.
- 403
FOLLOWUP_PATTERN_DETECTEDKonten email ditandai sebagai pola tindak lanjut mencurigakan yang berulang.
- 403
SCAM_PATTERN_DETECTEDKonten email ditandai sebagai pola penipuan.
- 403
SHARED_DOMAIN_REQUIRES_PAID_PLANDomain 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.
- 403
ACCOUNT_SUSPENDED_SPOOFINGAkun ditangguhkan karena berulang kali mencoba memalsukan header From.
- 409
IDEMPOTENCY_IN_PROGRESSPermintaan dengan Idempotency-Key yang sama masih diproses. Tunggu (Retry-After: 1) lalu ulangi dengan kunci yang sama.
- 422
IDEMPOTENCY_KEY_REUSEDIdempotency-Key ini sudah dipakai dengan body yang berbeda. Gunakan kunci baru untuk setiap email baru.
- 500
INTERNAL_SERVER_ERRORError server tak terduga. Coba lagi.
- 500
PARSE_ERRORGagal memproses konten email (gagal parse MIME).
- 500
PERSIST_FAILEDGagal memasukkan email ke antrean (gagal menyimpan ke database).
- 503
AUTH_UNAVAILABLEAPI key tidak dapat divalidasi saat ini. Coba lagi.
- 503
UNSUBSCRIBE_UNAVAILABLELayanan 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.
MARKETING_LIMIT_REACHEDDikembalikan 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"
}SHARED_DOMAIN_REQUIRES_PAID_PLANDikembalikan 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.
- 400
INVALID_JSONThe body is not {"commands":[...]} or has more than 20 commands.
- 401
MISSING_AUTH_HEADERNo Authorization header was sent.
- 401
INVALID_TOKENThe token is malformed, unknown or revoked.
- 401
TOKEN_EXPIREDThe access token has expired. Call Refresh Token and repeat the request.
- 401
INVALID_REFRESH_TOKENThe refresh token is invalid, expired, revoked or already used. Generate a new token in the dashboard.
- 429
RATE_LIMITEDMore than 15 requests/s or 15 in flight for the same IP + mailbox. Wait the number of seconds in Retry-After.
- 503
AUTH_UNAVAILABLEAuthentication 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.
- CMD
INVALID_ARGSA required argument is missing or invalid.
- CMD
UNKNOWN_COMMANDThe command name does not exist.
- CMD
NOT_FOUNDThe message, thread or folder does not exist for this token.
- CMD
INVALID_CURSORThe cursor is malformed or belongs to another account or folder.
- CMD
ALREADY_EXISTSA folder or label with this name already exists.
- CMD
NOT_IN_TRASHdelete only works on messages in Trash or Spam. Use move to send a message to Trash first.
- CMD
SENDER_NOT_FOUNDThe sender behind the token is not registered.
- CMD
SENDER_NO_DOMAINThe sender behind the token has no domain.
- CMD
NO_CREDITSThe account has fewer email credits than recipients (1 credit per copy).
- CMD
NO_RECIPIENTThe conversation has no recipient to reply to.
- CMD
INVALID_RULEThe rule is not valid. The message says which condition or action and why.
- CMD
LIMITThe mailbox reached the limit (100 rules, 200 templates or 100 labels).
- CMD
INVALID_TOADDRESSThe to address is not a valid email.
- CMD
INVALID_CCADDRESSOne of the cc addresses is not a valid email.
- CMD
INVALID_BCCADDRESSOne of the bcc addresses is not a valid email.
- CMD
INVALID_RECIPIENTThe recipient is missing or not a valid email.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc and bcc together have more than 50 addresses.
- CMD
INVALID_ATTACHMENTAn attachment content is not valid base64.
- CMD
FILE_BLOCKEDA file was blocked by the security scan.
- CMD
ATTACHMENTS_TOO_LARGEThe attachments of the email add up to more than 25 MB, or the mailbox already has 500 MB of uploads waiting to be sent.
- CMD
TOO_MANY_OPEN_COMPOSESThe 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.
- CMD
ATTACHMENT_MISSINGAn 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.
- CMD
ALREADY_SENTThe compose_uid belongs to an email that was already sent.
- CMD
INVALID_TIMEsend_at is missing, less than 1 minute away or more than 1 year away.
- CMD
MISSING_SUBJECTA new email needs a subject.
- CMD
MISSING_TARGETReply and forward need the original email, and it must still exist.
- CMD
DRAFT_NOT_FOUNDThe draft does not exist anymore: it was sent, deleted, or saved again (every save returns a new draft_id).
- CMD
NOT_SCHEDULEDThe email was already sent or canceled.
- CMD
SEND_FAILEDThe send was refused. The email is back in Drafts and the message says why.
- CMD
NO_UNSUBSCRIBEThe email has no List-Unsubscribe header.
- CMD
RECIPIENT_UNSUBSCRIBEDOne or more recipients unsubscribed from this mailbox. `recipients` lists them: remove them or send again with `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDMore than one address in `to` needs a paid plan.
- CMD
TOO_MANY_RECIPIENTS`to` has more than 30 addresses.
- CMD
INVALID_AUDIENCEThe audience is not valid: unknown group, a segment of another mailbox or a message this mailbox didn’t send.
- CMD
AUDIENCE_OVER_LIMITThe 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.
- CMD
EMPTY_AUDIENCENobody in this audience right now.
- CMD
BEST_TIME_NEEDS_AUDIENCE`best_time` needs an `audience` and `mode: new`.
- CMD
READ_ONLY_ACCESSThe token or app has Read only access and the command writes. In the attachment upload route it is HTTP 403.
- CMD
INTERNALServer error. The detail is only written to the server log.