E-Mails empfangen: Senden und Vertrauen
E-Mail senden
Senden Sie eine neue E-Mail vom Absender hinter Ihrem Token. Die Nachricht wird sofort unter Gesendet gespeichert und im Hintergrund zugestellt.
https://g.sendcorex.com/v1command: send_emailqueued: true bedeutet gespeichert und in der Warteschlange, nicht zugestellt. Die message_id in der Antwort ist vorläufig: Die echte SMTP-Message-ID ersetzt sie wenige Sekunden später und erscheint in get_messages.
Jeder Empfänger (to + cc + bcc) erhält eine eigene Kopie und verbraucht 1 Credit. Bcc-Adressen erscheinen nie in den Headern. Der Inhalt ist auf 2 MB begrenzt, Anhänge auf insgesamt 25 MB.
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
tostring | string[]erforderlichEmpfängeradresse oder eine Liste mit bis zu 30 Adressen (kostenpflichtige Tarife). Mit
unsubscribe: trueerhält jede Person eine eigene Kopie; ohne sehen sich alle intoundccgegenseitig.to_namestringoptionalName des Empfängers. Standard ist der Teil vor dem
@.subjectstringerforderlichBetreff der E-Mail.
htmlstringoptionalHTML-Inhalt. Senden Sie
htmlodertext.textstringoptionalKlartext-Inhalt. Er wird mit
<br>in HTML umgewandelt.ccstring[]optionalSichtbare Kopien. to + cc + bcc bis zu 50 Adressen.
bccstring[]optionalVerdeckte Kopien. Sie erscheinen nie in den Headern.
template_idstringoptionalFüllt den Inhalt (und einen leeren Betreff) aus einem Template. Die Platzhalter verwenden
to_nameundvariables.variablesobjectoptionalIhre eigenen Template-Platzhalter:
{ "company": "Acme" }füllt{company}.attachmentsobject[]optionalDateien:
[{ file_name, content, content_type }],contentin Base64. Bis zu 20 Dateien, insgesamt 25 MB. Jede Datei wird geprüft.compose_uidstringoptionalZuvor mit
upload_attachmenthochgeladene Anhänge.attachment_idsstring[]optionalWelche hochgeladenen Anhänge gesendet werden. Ohne Angabe alle.
followup_atstringoptionalErinnert Sie, wenn bis zu diesem Datum niemand antwortet (RFC 3339,
YYYY-MM-DDoder Epoch ms).labelstringoptionalEin Label für die gesendete Nachricht. Es wird zu
labels: [label].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.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "send_email",
args: {
to: "client@example.com",
to_name: "Client",
cc: [
"manager@example.com"
],
subject: "Quote",
html: "<p>Here is the quote.</p>",
attachments: [
{
file_name: "quote.pdf",
content: "JVBERi0xLjcKJcfsj6IK…",
content_type: "application/pdf"
}
],
followup_at: "2026-10-29T09:00:00+08:00",
label: "sales"
}
}
]
},
{ 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": "send_email",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"recipients": 2,
"queued": true
}
}
]
}Antwortfelder
message_uidDie ID der gesendeten Nachricht. Sie erscheint sofort in
Sent.thread_idDie Konversation der neuen Nachricht.
message_idEine vorläufige Message-ID. Die echte SMTP-ID ersetzt sie kurz darauf.
recipientsWie viele Kopien in die Warteschlange gestellt wurden (to + cc + bcc), je 1 Credit.
queuedtrue= gespeichert und zur Zustellung eingereiht. Bedeutet nicht zugestellt.
Wiederholtes Senden
Derselbe Schreibvorgang (gleiche args), der innerhalb von 1,5 Sekunden wiederholt wird, liefert das erste Ergebnis, statt erneut zu senden. Eine Polling-Schleife, die dieselbe E-Mail zweimal sendet, dupliziert sie nicht.
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
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_TOADDRESSDie to-Adresse ist keine gültige E-Mail.
- CMD
INVALID_CCADDRESSEine der cc-Adressen ist keine gültige E-Mail.
- CMD
INVALID_BCCADDRESSEine der bcc-Adressen ist keine gültige E-Mail.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 Adressen.
- CMD
INVALID_ATTACHMENTDer Inhalt eines Anhangs ist kein gültiges Base64.
- 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
ATTACHMENT_MISSINGEin hochgeladener Anhang existiert nicht mehr (Uploads, die nicht innerhalb von 48 Stunden gesendet und nicht von einem Entwurf oder einer geplanten E-Mail verwendet werden, werden gelöscht). Laden Sie ihn erneut hoch.
- CMD
NO_CREDITSDas Konto hat weniger E-Mail-Credits als Empfänger (1 Credit pro Kopie).
- CMD
SENDER_NOT_FOUNDDer Absender hinter dem Token ist nicht registriert.
- CMD
SENDER_NO_DOMAINDer Absender hinter dem Token hat keine Domain.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.