E-Mails empfangen: Planen
Versand planen
Schreiben Sie die E-Mail jetzt und senden Sie sie später. Sie wartet im Ordner Scheduled bis zu der von Ihnen gewählten Zeit.
https://g.sendcorex.com/v1command: schedule_sendAlles, was sich prüfen lässt, wird jetzt geprüft (Empfänger, Betreff, Original-E-Mail, Anhänge), damit Sie es vor dem Zeitpunkt erfahren. Credits und das Tageslimit werden beim Versand geprüft.
Wird der Versand zu diesem Zeitpunkt abgelehnt (keine Credits, Tageslimit, Spam), geht nichts verloren: Die E-Mail kehrt mit dem Grund zu den Entwürfen zurück.
Empfänger, die das Tracking auf der Einstellungsseite abgelehnt haben, werden nie erfasst, auch nicht mit true.
E-Mails aus dem Postfach enthalten keinen List-Unsubscribe-Header und keinen Abmeldelink, außer Sie senden unsubscribe: true, da es persönliche E-Mails sind.
Jede Person, die eine E-Mail aus dem Postfach erhält, wird Kontakt in der Liste „Webmail“ des Kontos und gilt in diesem Postfach als trusted: Ihre Antworten landen in der Inbox und die Adresse erscheint in der Autovervollständigung. Vom Postfach blockierte Absender bleiben blockiert.
Mit unsubscribe: true werden Empfänger, die sich von diesem Postfach bereits abgemeldet haben, mit RECIPIENT_UNSUBSCRIBED abgelehnt; recipients listet sie auf. Antworten werden nie blockiert.
Argumente
send_atstringerforderlichRFC 3339,
YYYY-MM-DDoder Epoch ms. Mindestens 1 Minute ab jetzt und höchstens 1 Jahr.modestringoptionalnew(Standard),replyoderforward.idstringoptionalDie Originalnachricht, für
replyundforward.tostring | string[]optionalEmpfänger. Pflicht bei
newundforward. Beinewkann es eine Liste mit bis zu 30 sein (kostenpflichtige Tarife).ccstring[]optionalSichtbare Kopien.
bccstring[]optionalVerdeckte Kopien.
subjectstringoptionalErforderlich für
new. Reply und forward verwenden standardmäßig Re: / Fwd: Original.htmlstringoptionalHTML-Inhalt. Oder
textodertemplate_id.template_idstringoptionalFüllt den Inhalt (und den Betreff einer neuen E-Mail) aus einem Template.
followup_after_hoursnumberoptionalErinnert Sie, wenn so viele Stunden nach dem Versand niemand antwortet.
scheduled_idstringoptionalNeu planen: Die alte geplante E-Mail wird ersetzt.
attachmentsobject[]optionalAnzuhängende Dateien:
[{ file_name, content, content_type }],contentin Base64. Bis zu 20 Dateien und insgesamt 25 MB. Jede Datei wird geprüft; eine gefährliche schlägt mitFILE_BLOCKEDfehl.compose_uidstringoptionalAnhänge, die Sie zuvor mit
upload_attachmenthochgeladen haben.attachment_idsstring[]optionalWelche der hochgeladenen Anhänge gesendet werden. Ohne Angabe alle.
track_opensbooleanoptionalErfasst, wann jeder Empfänger die E-Mail öffnet (unsichtbares Pixel). Standard
true.track_clicksbooleanoptionalErfasst Klicks auf Links (jeder Link läuft über eine Weiterleitung). Standard
true.unsubscribebooleanoptionalFügt einen Abmeldelink hinzu. Setzen Sie
[unsubscribe]in den Text (alshrefeines Links oder als Klartext) an die Stelle des Links; fehlt es, wird am Ende eine Standardzeile ergänzt. Standardfalse.audiencestringoptionalSendet an eine Zielgruppe statt an Adressen:
subscribed,opened,clicked,both,seg:<segment_id>odermsg:<message_uid>:opened|clicked|not_opened.towird optional. Bis zu 5.000 Personen. Der Abmeldelink wird aktiviert und die E-Mail geht als Marketing raus. Kostenpflichtige Tarife.best_timebooleanoptionalSendet jeder Person zu der Uhrzeit, zu der sie normalerweise öffnet oder klickt, am Tag von
send_at. Erfordertaudienceundmode: new.send_atist 00:00 dieses Tages in Ihrer Zeitzone, als UTC.best_fallback_atstring | numberoptionalUhrzeit für Personen ohne Verlauf (RFC 3339 oder Epoch-ms). Muss am selben Tag wie
send_atliegen.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "schedule_send",
args: {
to: "ana@client.com",
subject: "Proposal",
html: "<p>Hi Ana, here is the proposal.</p>",
send_at: "2026-10-27T09:00:00+08:00"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "schedule_send",
"id": "0",
"type": "SUCCESS",
"data": {
"scheduled_id": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"send_at": "2026-10-27T01:00:00Z"
}
}
]
}Antwortfelder
scheduled_idDie Nachricht in Scheduled. Verwenden Sie sie zum Abbrechen, Neuplanen oder sofortigen Senden.
Geplante E-Mails auflisten
Die geplanten E-Mails liegen im Ordner Scheduled, sortiert nach Sendezeit.
Request-Body
{
"commands": [
{
"command": "list_messages",
"args": {
"folder": "Scheduled"
}
}
]
}Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
TOKEN_EXPIREDDer Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.
- 401
INVALID_TOKENDer Token ist fehlerhaft, unbekannt oder widerrufen.
- 429
RATE_LIMITEDMehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.
- CMD
INVALID_AUDIENCEDie Zielgruppe ist ungültig: unbekannte Gruppe, Segment eines anderen Postfachs oder eine Nachricht, die dieses Postfach nicht gesendet hat.
- CMD
AUDIENCE_OVER_LIMITDie Zielgruppe hat mehr Personen, als Sie senden können (bis 5.000 pro E-Mail und Ihr Tageslimit). `total` und `allowed` nennen die Zahlen.
- CMD
EMPTY_AUDIENCEDerzeit niemand in dieser Zielgruppe.
- CMD
BEST_TIME_NEEDS_AUDIENCE`best_time` erfordert ein `audience` und `mode: new`.
- CMD
RECIPIENT_UNSUBSCRIBEDEin oder mehrere Empfänger haben sich von diesem Postfach abgemeldet. `recipients` listet sie auf: Entfernen Sie sie oder senden Sie erneut mit `unsubscribe: false`.
- CMD
PAID_PLAN_REQUIREDMehr als eine Adresse in `to` erfordert einen kostenpflichtigen Tarif.
- CMD
TOO_MANY_RECIPIENTS`to` enthält mehr als 30 Adressen.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
INVALID_TIMEsend_at fehlt, liegt weniger als 1 Minute oder mehr als 1 Jahr entfernt.
- CMD
INVALID_RECIPIENTDer Empfänger fehlt oder ist keine gültige E-Mail.
- CMD
MISSING_SUBJECTEine neue E-Mail braucht einen Betreff.
- CMD
MISSING_TARGETReply und forward brauchen die Original-E-Mail, und diese muss noch existieren.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 Adressen.
- CMD
FILE_BLOCKEDEine Datei wurde von der Sicherheitsprüfung blockiert.
- CMD
ATTACHMENTS_TOO_LARGEDie Anhänge der E-Mail ergeben zusammen mehr als 25 MB, oder das Postfach hat bereits 500 MB an Uploads, die auf den Versand warten.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.