E-Mail planen
Verwenden Sie denselben Sende-Endpoint mit dem Parameter scheduled_at, um die Zustellung zu verzögern. Akzeptiert ISO-8601-Daten oder natürliche Sprache. Die E-Mail kann bis zum Versand storniert werden.
https://mail.sendcorex.com/v3.0/sendSpeichern Sie die zurückgegebene id. Sie brauchen sie, umdie E-Mail zu stornieren, bevor sie gesendet wird.
Zusätzlicher Parameter
scheduled_atstringoptionalneuWann die E-Mail gesendet werden soll. Akzeptiert das ISO-8601-Format oder natürliche Sprache. Muss in der Zukunft liegen.
z. B.
"in 1 hour" · "tomorrow at 9am" · "2026-08-05T11:52:01Z"
Alle anderen Parameter sind identisch mit E-Mail senden.
Natürliche Sprache
Jedes dieser Formate funktioniert für scheduled_at.
"in 1 hour""in 30 minutes""tomorrow at 9am""Friday at 3pm ET""next Monday at 8am""2026-08-05T11:52:01Z"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://mail.sendcorex.com/v3.0/send',
{
to: 'user@example.com',
from: 'noreply@yourdomain.com',
senderName: 'My App',
subject: 'Your weekly digest',
body: '<p>Here is what happened this week...</p>',
scheduled_at: 'tomorrow at 9am',
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } }
);
// Save the id: you need it to cancel the email before it is sent
const { id, ids, scheduledAt, recipients } = response.data;
console.log('Scheduled for ' + scheduledAt + ' (id: ' + id + ')');Antwort
{
"success": true,
"message": "Email scheduled successfully",
"code": "EMAIL_SCHEDULED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"ids": [
{ "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f", "recipient": "user@example.com" }
],
"scheduledAt": "2026-04-26T09:00:00.000Z",
"recipients": 1
}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.