Header Berhenti Berlangganan
Tambahkan header List-Unsubscribe ke email Anda agar penerima (dan penyedia mailbox seperti Gmail dan Yahoo) bisa berhenti berlangganan tanpa menandai email Anda sebagai spam. Ini sangat meningkatkan deliverability untuk pengiriman massal dan marketing.
https://mail.sendcorex.com/v3.0/sendPenyedia mailbox sangat menyarankan (dan dalam beberapa kasus mewajibkan) List-Unsubscribe pada setiap email massal. Tanpa header ini, pengiriman bervolume tinggi bisa lebih sulit masuk ke kotak masuk.
Header dimasukkan ke objek headers pada permintaan pengiriman. Untuk aturan penamaan yang berlaku bagi semua header lain, lihatHeader Kustom.
Header yang didukung
List-UnsubscribeopsionalDaftar metode berhenti berlangganan yang dipisahkan koma, diapit tanda kurung sudut. Mendukung link mailto: dan https:.
mis.
"<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>"List-Unsubscribe-PostopsionalMengaktifkan berhenti berlangganan sekali klik di Gmail/Yahoo. Wajib jika Anda ingin tombol "Berhenti berlangganan" muncul langsung di UI kotak masuk. Harus persis:
mis.
"List-Unsubscribe=One-Click"List-IdopsionalMengidentifikasi mailing list tempat email ini berada.
mis.
"My List <mylist.yourdomain.com>"
Link berhenti berlangganan otomatis
Jika Anda tidak punya sistem berhenti berlangganan sendiri, Sendcorex bisa membuat dan mengelola link berhenti berlangganan dan mailto untuk Anda. Atur unsubscribe: true pada permintaan pengiriman, dan sertakan salah satu placeholder yang didukung di body, di tempat Anda ingin link disisipkan.
Placeholder yang didukung
[unsubscribe_url][unsubscribe][unsub_url][opt_out_url]
Gunakan salah satunya di dalam href (atau di mana saja di body). Sendcorex menggantinya dengan link berhenti berlangganan asli untuk setiap penerima sebelum mengirim.
unsubscribe: true, tanpa sistem sendiri
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"senderName": "My App",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p>Thanks for signing up.</p><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"replyTo": "support@yourdomain.com",
"unsubscribe": true
}Jika unsubscribe: true diatur tetapi tidak ada placeholder yang didukung di body, permintaan gagal dengan MISSING_UNSUBSCRIBE_PLACEHOLDER. Lihatrespons 400.
Daftar kontak
opsionalcontact_list tidak wajib. Field ini hanya mengatur di daftar mana penerima disimpan, untuk pelacakan dan pengorganisasian. Field ini tidak ada hubungannya dengan link berhenti berlangganan itu sendiri.
Tanpa contact_list (default)
Kontak otomatis disimpan ke daftar default bernama "API Contacts". Nama ini tidak bisa diubah. Anda bisa memeriksanya kapan saja didaftar kontak.
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"unsubscribe": true
}Dengan contact_list (nama kustom)
Jika daftar belum ada, daftar dibuat secara otomatis. Ini berguna untuk memisahkan audiens, misalnya satu daftar per kampanye atau platform.
"CRM 2026 - Gmail""Newsletter - Trial Users""Support Tickets"
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"unsubscribe": true,
"contact_list": "CRM 2026 - Gmail"
}Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'contact@gmail.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Welcome aboard!',
body: '<h1>Welcome!</h1><p>Thanks for signing up.</p><p><a href="[unsubscribe]">Unsubscribe</a></p>',
unsubscribe: true,
contact_list: 'CRM 2026 - Gmail',
headers: {
'List-Id': 'My List <mylist.yourdomain.com>',
'List-Unsubscribe':
'<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>',
'List-Unsubscribe-Post': 'List-Unsubscribe=One-Click',
},
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
const { id } = response.data;Respons
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}Error
Semua kode error →Error mengembalikan objek JSON dengan error dan code.
- 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
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.