Abmelde-Header
Fügen Sie Ihren E-Mails List-Unsubscribe-Header hinzu, damit Empfänger (und Mailbox-Provider wie Gmail und Yahoo) sich abmelden können, ohne Ihre E-Mail als Spam zu markieren. Das verbessert die Zustellbarkeit bei Massen- und Marketing-Versand deutlich.
https://mail.sendcorex.com/v3.0/sendMailbox-Provider empfehlen dringend (und verlangen teilweise) List-Unsubscribe bei jedem Massenversand. Fehlt dieser Header bei großen Versandmengen, kann das die Zustellung in den Posteingang beeinträchtigen.
Header gehören in das Objekt headers der Sendeanfrage. Zu den Namensregeln für alle anderen Header sieheBenutzerdefinierte Header.
Unterstützte Header
List-UnsubscribeoptionalKommagetrennte Liste von Abmeldemethoden in spitzen Klammern. Unterstützt sowohl einen mailto:- als auch einen https:-Link.
z. B.
"<mailto:unsubscribe@yourdomain.com?subject=unsubscribe>,<https://yourdomain.com/unsubscribe?u=123>"List-Unsubscribe-PostoptionalAktiviert die Ein-Klick-Abmeldung von Gmail/Yahoo. Erforderlich, wenn der Button „Abbestellen“ direkt in der Posteingangsoberfläche erscheinen soll. Muss genau lauten:
z. B.
"List-Unsubscribe=One-Click"List-IdoptionalKennzeichnet die Mailingliste, zu der diese E-Mail gehört.
z. B.
"My List <mylist.yourdomain.com>"
Automatischer Abmeldelink
Wenn Sie kein eigenes Abmeldesystem haben, kann Sendcorex den Abmeldelink und das mailto für Sie erzeugen und verwalten. Setzen Sie unsubscribe: true in der Sendeanfrage und fügen Sie einen der unterstützten Platzhalter dort in den Text ein, wo der Link stehen soll.
Unterstützte Platzhalter
[unsubscribe_url][unsubscribe][unsub_url][opt_out_url]
Verwenden Sie einen davon in einem href (oder irgendwo im Text). Sendcorex ersetzt ihn vor dem Versand durch den echten Abmeldelink des jeweiligen Empfängers.
unsubscribe: true, ohne eigenes System
{
"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
}Ist unsubscribe: true gesetzt, aber keiner der unterstützten Platzhalter im Text vorhanden, schlägt die Anfrage mit MISSING_UNSUBSCRIBE_PLACEHOLDER fehl. Siehe die400-Antwort.
Kontaktliste
optionalcontact_list ist nicht erforderlich. Es legt nur fest, in welcher Liste der Empfänger für Tracking und Organisation gespeichert wird. Mit dem Abmeldelink selbst hat es nichts zu tun.
Ohne contact_list (Standard)
Der Kontakt wird automatisch in einer Standardliste namens "API Contacts" gespeichert. Dieser Name kann nicht geändert werden. Sie können sie jederzeit einsehen in IhrenKontaktlisten.
{
"to": "contact@gmail.com",
"from": "noreply@yourdomain.com",
"subject": "Welcome aboard!",
"body": "<h1>Welcome!</h1><p><a href=\"[unsubscribe]\">Unsubscribe</a></p>",
"unsubscribe": true
}Mit contact_list (eigener Name)
Existiert die Liste noch nicht, wird sie automatisch angelegt. Das ist nützlich, um Zielgruppen zu trennen, zum Beispiel eine Liste pro Kampagne oder Plattform.
"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"
}Schnellstart
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;Antwort
{
"success": true,
"message": "Email queued successfully",
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}Fehler
Alle Fehlercodes →Fehler liefern ein JSON-Objekt mit error und code.
- 401
MISSING_AUTH_HEADERKein Authorization-Header vorhanden.
- 401
INVALID_API_KEYDer API-Schlüssel ist ungültig oder widerrufen.
- 401
ACCOUNT_BLOCKEDDas Konto wurde gesperrt.
- 401
NO_CREDITS_LEFTNicht genug E-Mail-Credits für alle Empfänger. Jede Adresse in to, cc und bcc verbraucht 1 Credit.
- 401
DOMAIN_NOT_VALIDATEDAbsender-Domain nicht verifiziert.
- 401
LISTED_SPAM_HAUSDie Absender-Domain ist bei Spamhaus gelistet.
- 401
ISP_DOMAIN_BLOCKEDDer Versand von bekannten Domains (gmail.com, outlook.com usw.) ist nicht erlaubt.
- 401
FROM_HEADER_DOMAIN_MISMATCHDomain des From-Headers ist für diesen Absender nicht autorisiert.
- 401
USER_NOT_FOUNDBenutzer nicht gefunden.
- 401
MISSING_USER_PRIVILEGESFehlende Benutzerrechte.
- 401
EMAIL_CREDITS_NOT_FOUNDFehler beim Abrufen der E-Mail-Credits.
- 401
EMAIL_NOT_VALIDATEDDie E-Mail-Adresse des Kontos wurde noch nicht verifiziert.
- 429
CREDENTIAL_TEMPORARILY_BLOCKEDAPI-Schlüssel wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.
- 429
IP_TEMPORARILY_BLOCKEDAnfragende IP wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.
- 429
TOO_MANY_CONCURRENT_CONNECTIONSZu viele gleichzeitige Anfragen von dieser IP. Versuchen Sie es gleich erneut.
- 400
INVALID_JSONDer Request-Body ist kein gültiges JSON.
- 400
MISSING_FROMDas Feld from fehlt oder ist leer.
- 400
INVALID_FROM_FORMATDas Feld from muss eine gültige E-Mail-Adresse sein.
- 400
MISSING_SENDERNAMEDas Feld senderName fehlt oder ist leer.
- 400
INVALID_SENDERNAME_FORMATDas Feld senderName enthält ungültige Zeichen.
- 400
MISSING_SUBJECTDas Feld subject fehlt oder ist leer.
- 400
MISSING_BODYDas Feld body fehlt oder ist leer.
- 400
MISSING_TOADDRESSDas Feld to fehlt oder ist leer.
- 400
MISSING_TODas Feld to fehlt oder ist leer.
- 400
INVALID_TOADDRESSEine oder mehrere Empfängeradressen sind fehlerhaft.
- 400
TOADDRESS_LIMIT_EXCEEDEDMehr als 50 Empfänger im Array to.
- 400
INVALID_CCADDRESSEine oder mehrere cc-Adressen sind fehlerhaft.
- 400
INVALID_BCCADDRESSEine oder mehrere bcc-Adressen sind fehlerhaft.
- 400
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 eindeutige Empfänger.
- 400
INVALID_SCHEDULED_ATscheduled_at ist kein gültiges Datum oder liegt in der Vergangenheit.
- 400
INVALID_SENDER_FORMATDas Format der Absenderadresse ist ungültig.
- 400
HEADER_NOT_ALLOWEDDer Schlüssel des eigenen Headers steht nicht auf der Liste der erlaubten (List-Unsubscribe, List-Id, X-* usw.).
- 400
INVALID_HEADER_VALUEDer Header-Wert enthält ungültige Zeichen (CR/LF nicht erlaubt).
- 400
DANGEROUS_ATTACHMENTEin oder mehrere Anhänge wurden aus Sicherheitsgründen blockiert.
- 400
INVALID_ATTACHMENTDer Inhalt eines Anhangs ist kein gültiges base64.
- 400
MISSING_UNSUBSCRIBE_PLACEHOLDERunsubscribe ist true, aber der body enthält keinen Abmelde-Platzhalter ([unsubscribe_url], [unsubscribe], [unsub_url] oder [opt_out_url]).
- 403
ACCOUNT_RESTRICTEDDas Konto ist vorübergehend eingeschränkt.
- 403
DAILY_LIMITTägliches Versandlimit erreicht.
- 403
MARKETING_LIMIT_REACHEDTägliches Marketing-Limit des Free-Plans erreicht: 30 Marketing- oder Kaltakquise-E-Mails pro Tag, pro Empfänger gezählt in einem gleitenden 24-Stunden-Fenster. Die Antwort enthält limit, used, recipients und upgradeUrl. Transaktionale E-Mails werden weiter versendet; nichts wird in die Warteschlange gestellt.
- 403
FORBIDDEN_HTML_CONTENTDas HTML enthält aktive Inhalte, die in E-Mails nicht erlaubt sind (script, iframe, form, input, button, embed, object, svg, on*-Handler, javascript:-Links, meta refresh…). Die Antwort listet die Funde auf. Verwenden Sie ein gestyltes <a> statt Buttons oder Formularen.
- 403
SPAM_DETECTEDE-Mail-Inhalt als Spam erkannt. Die Antwort enthält die quarantine_id und Anweisungen zur Freigabe.
- 403
SENDER_NAME_MISMATCHMehrere Absendernamen für dieselbe Adresse erkannt.
- 403
FOLLOWUP_PATTERN_DETECTEDE-Mail-Inhalt als wiederholtes verdächtiges Follow-up-Muster erkannt.
- 403
SCAM_PATTERN_DETECTEDE-Mail-Inhalt als Betrugsmuster erkannt.
- 403
ACCOUNT_SUSPENDED_SPOOFINGKonto wegen wiederholter Versuche, den From-Header zu fälschen, gesperrt.
- 409
IDEMPOTENCY_IN_PROGRESSEine Anfrage mit demselben Idempotency-Key wird noch verarbeitet. Warte (Retry-After: 1) und wiederhole mit demselben Schlüssel.
- 422
IDEMPOTENCY_KEY_REUSEDDieser Idempotency-Key wurde bereits mit einem anderen Body verwendet. Nutze für jede neue E-Mail einen neuen Schlüssel.
- 500
INTERNAL_SERVER_ERRORUnerwarteter Serverfehler. Versuchen Sie es erneut.
- 500
PARSE_ERRORE-Mail-Inhalt konnte nicht verarbeitet werden (MIME-Parse-Fehler).
- 500
PERSIST_FAILEDE-Mail konnte nicht in die Warteschlange gestellt werden (Fehler beim Speichern in der Datenbank).
- 503
AUTH_UNAVAILABLEDer API-Schlüssel konnte gerade nicht geprüft werden. Versuchen Sie es erneut.
- 503
UNSUBSCRIBE_UNAVAILABLEDienst für Abmeldelinks vorübergehend nicht verfügbar. Versuchen Sie es später erneut.