E-Mail

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.

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

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

i

Header gehören in das Objekt headers der Sendeanfrage. Zu den Namensregeln für alle anderen Header sieheBenutzerdefinierte Header.

Unterstützte Header

  • List-Unsubscribeoptional

    Kommagetrennte 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-Postoptional

    Aktiviert 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-Idoptional

    Kennzeichnet 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

optional

contact_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 liefern ein JSON-Objekt mit error und code.

  • 401MISSING_AUTH_HEADER

    Kein Authorization-Header vorhanden.

  • 401INVALID_API_KEY

    Der API-Schlüssel ist ungültig oder widerrufen.

  • 401ACCOUNT_BLOCKED

    Das Konto wurde gesperrt.

  • 401NO_CREDITS_LEFT

    Nicht genug E-Mail-Credits für alle Empfänger. Jede Adresse in to, cc und bcc verbraucht 1 Credit.

  • 401DOMAIN_NOT_VALIDATED

    Absender-Domain nicht verifiziert.

  • 401LISTED_SPAM_HAUS

    Die Absender-Domain ist bei Spamhaus gelistet.

  • 401ISP_DOMAIN_BLOCKED

    Der Versand von bekannten Domains (gmail.com, outlook.com usw.) ist nicht erlaubt.

  • 401FROM_HEADER_DOMAIN_MISMATCH

    Domain des From-Headers ist für diesen Absender nicht autorisiert.

  • 401USER_NOT_FOUND

    Benutzer nicht gefunden.

  • 401MISSING_USER_PRIVILEGES

    Fehlende Benutzerrechte.

  • 401EMAIL_CREDITS_NOT_FOUND

    Fehler beim Abrufen der E-Mail-Credits.

  • 401EMAIL_NOT_VALIDATED

    Die E-Mail-Adresse des Kontos wurde noch nicht verifiziert.

  • 429CREDENTIAL_TEMPORARILY_BLOCKED

    API-Schlüssel wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.

  • 429IP_TEMPORARILY_BLOCKED

    Anfragende IP wegen wiederholter Richtlinienverstöße vorübergehend gesperrt.

  • 429TOO_MANY_CONCURRENT_CONNECTIONS

    Zu viele gleichzeitige Anfragen von dieser IP. Versuchen Sie es gleich erneut.

  • 400INVALID_JSON

    Der Request-Body ist kein gültiges JSON.

  • 400MISSING_FROM

    Das Feld from fehlt oder ist leer.

  • 400INVALID_FROM_FORMAT

    Das Feld from muss eine gültige E-Mail-Adresse sein.

  • 400MISSING_SENDERNAME

    Das Feld senderName fehlt oder ist leer.

  • 400INVALID_SENDERNAME_FORMAT

    Das Feld senderName enthält ungültige Zeichen.

  • 400MISSING_SUBJECT

    Das Feld subject fehlt oder ist leer.

  • 400MISSING_BODY

    Das Feld body fehlt oder ist leer.

  • 400MISSING_TOADDRESS

    Das Feld to fehlt oder ist leer.

  • 400MISSING_TO

    Das Feld to fehlt oder ist leer.

  • 400INVALID_TOADDRESS

    Eine oder mehrere Empfängeradressen sind fehlerhaft.

  • 400TOADDRESS_LIMIT_EXCEEDED

    Mehr als 50 Empfänger im Array to.

  • 400INVALID_CCADDRESS

    Eine oder mehrere cc-Adressen sind fehlerhaft.

  • 400INVALID_BCCADDRESS

    Eine oder mehrere bcc-Adressen sind fehlerhaft.

  • 400RECIPIENT_LIMIT_EXCEEDED

    to, cc und bcc haben zusammen mehr als 50 eindeutige Empfänger.

  • 400INVALID_SCHEDULED_AT

    scheduled_at ist kein gültiges Datum oder liegt in der Vergangenheit.

  • 400INVALID_SENDER_FORMAT

    Das Format der Absenderadresse ist ungültig.

  • 400HEADER_NOT_ALLOWED

    Der Schlüssel des eigenen Headers steht nicht auf der Liste der erlaubten (List-Unsubscribe, List-Id, X-* usw.).

  • 400INVALID_HEADER_VALUE

    Der Header-Wert enthält ungültige Zeichen (CR/LF nicht erlaubt).

  • 400DANGEROUS_ATTACHMENT

    Ein oder mehrere Anhänge wurden aus Sicherheitsgründen blockiert.

  • 400INVALID_ATTACHMENT

    Der Inhalt eines Anhangs ist kein gültiges base64.

  • 400MISSING_UNSUBSCRIBE_PLACEHOLDER

    unsubscribe ist true, aber der body enthält keinen Abmelde-Platzhalter ([unsubscribe_url], [unsubscribe], [unsub_url] oder [opt_out_url]).

  • 403ACCOUNT_RESTRICTED

    Das Konto ist vorübergehend eingeschränkt.

  • 403DAILY_LIMIT

    Tägliches Versandlimit erreicht.

  • 403MARKETING_LIMIT_REACHED

    Tä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.

  • 403FORBIDDEN_HTML_CONTENT

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

  • 403SPAM_DETECTED

    E-Mail-Inhalt als Spam erkannt. Die Antwort enthält die quarantine_id und Anweisungen zur Freigabe.

  • 403SENDER_NAME_MISMATCH

    Mehrere Absendernamen für dieselbe Adresse erkannt.

  • 403FOLLOWUP_PATTERN_DETECTED

    E-Mail-Inhalt als wiederholtes verdächtiges Follow-up-Muster erkannt.

  • 403SCAM_PATTERN_DETECTED

    E-Mail-Inhalt als Betrugsmuster erkannt.

  • 403ACCOUNT_SUSPENDED_SPOOFING

    Konto wegen wiederholter Versuche, den From-Header zu fälschen, gesperrt.

  • 409IDEMPOTENCY_IN_PROGRESS

    Eine Anfrage mit demselben Idempotency-Key wird noch verarbeitet. Warte (Retry-After: 1) und wiederhole mit demselben Schlüssel.

  • 422IDEMPOTENCY_KEY_REUSED

    Dieser Idempotency-Key wurde bereits mit einem anderen Body verwendet. Nutze für jede neue E-Mail einen neuen Schlüssel.

  • 500INTERNAL_SERVER_ERROR

    Unerwarteter Serverfehler. Versuchen Sie es erneut.

  • 500PARSE_ERROR

    E-Mail-Inhalt konnte nicht verarbeitet werden (MIME-Parse-Fehler).

  • 500PERSIST_FAILED

    E-Mail konnte nicht in die Warteschlange gestellt werden (Fehler beim Speichern in der Datenbank).

  • 503AUTH_UNAVAILABLE

    Der API-Schlüssel konnte gerade nicht geprüft werden. Versuchen Sie es erneut.

  • 503UNSUBSCRIBE_UNAVAILABLE

    Dienst für Abmeldelinks vorübergehend nicht verfügbar. Versuchen Sie es später erneut.