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.

POSThttps://g.sendcorex.com/v1command: send_email
i

queued: 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.

i

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.

i

Empfänger, die das Tracking auf der Einstellungsseite abgelehnt haben, werden nie erfasst, auch nicht mit true.

i

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.

i

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.

i

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[]erforderlich

    Empfängeradresse oder eine Liste mit bis zu 30 Adressen (kostenpflichtige Tarife). Mit unsubscribe: true erhält jede Person eine eigene Kopie; ohne sehen sich alle in to und cc gegenseitig.

  • to_namestringoptional

    Name des Empfängers. Standard ist der Teil vor dem @.

  • subjectstringerforderlich

    Betreff der E-Mail.

  • htmlstringoptional

    HTML-Inhalt. Senden Sie html oder text.

  • textstringoptional

    Klartext-Inhalt. Er wird mit <br> in HTML umgewandelt.

  • ccstring[]optional

    Sichtbare Kopien. to + cc + bcc bis zu 50 Adressen.

  • bccstring[]optional

    Verdeckte Kopien. Sie erscheinen nie in den Headern.

  • template_idstringoptional

    Füllt den Inhalt (und einen leeren Betreff) aus einem Template. Die Platzhalter verwenden to_name und variables.

  • variablesobjectoptional

    Ihre eigenen Template-Platzhalter: { "company": "Acme" } füllt {company}.

  • attachmentsobject[]optional

    Dateien: [{ file_name, content, content_type }], content in Base64. Bis zu 20 Dateien, insgesamt 25 MB. Jede Datei wird geprüft.

  • compose_uidstringoptional

    Zuvor mit upload_attachment hochgeladene Anhänge.

  • attachment_idsstring[]optional

    Welche hochgeladenen Anhänge gesendet werden. Ohne Angabe alle.

  • followup_atstringoptional

    Erinnert Sie, wenn bis zu diesem Datum niemand antwortet (RFC 3339, YYYY-MM-DD oder Epoch ms).

  • labelstringoptional

    Ein Label für die gesendete Nachricht. Es wird zu labels: [label].

  • track_opensbooleanoptional

    Erfasst, wann jeder Empfänger die E-Mail öffnet (unsichtbares Pixel). Standard true.

  • track_clicksbooleanoptional

    Erfasst Klicks auf Links (jeder Link läuft über eine Weiterleitung). Standard true.

  • unsubscribebooleanoptional

    Fügt einen Abmeldelink hinzu. Setzen Sie [unsubscribe] in den Text (als href eines Links oder als Klartext) an die Stelle des Links; fehlt es, wird am Ende eine Standardzeile ergänzt. Standard false.

  • audiencestringoptional

    Sendet an eine Zielgruppe statt an Adressen: subscribed, opened, clicked, both, seg:<segment_id> oder msg:<message_uid>:opened|clicked|not_opened. to wird 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_uid

    Die ID der gesendeten Nachricht. Sie erscheint sofort in Sent.

  • thread_id

    Die Konversation der neuen Nachricht.

  • message_id

    Eine vorläufige Message-ID. Die echte SMTP-ID ersetzt sie kurz darauf.

  • recipients

    Wie viele Kopien in die Warteschlange gestellt wurden (to + cc + bcc), je 1 Credit.

  • queued

    true = 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.

  • 401TOKEN_EXPIRED

    Der Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

  • 429RATE_LIMITED

    Mehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.

  • CMDINVALID_AUDIENCE

    Die Zielgruppe ist ungültig: unbekannte Gruppe, Segment eines anderen Postfachs oder eine Nachricht, die dieses Postfach nicht gesendet hat.

  • CMDAUDIENCE_OVER_LIMIT

    Die Zielgruppe hat mehr Personen, als Sie senden können (bis 5.000 pro E-Mail und Ihr Tageslimit). `total` und `allowed` nennen die Zahlen.

  • CMDEMPTY_AUDIENCE

    Derzeit niemand in dieser Zielgruppe.

  • CMDRECIPIENT_UNSUBSCRIBED

    Ein oder mehrere Empfänger haben sich von diesem Postfach abgemeldet. `recipients` listet sie auf: Entfernen Sie sie oder senden Sie erneut mit `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    Mehr als eine Adresse in `to` erfordert einen kostenpflichtigen Tarif.

  • CMDTOO_MANY_RECIPIENTS

    `to` enthält mehr als 30 Adressen.

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDINVALID_TOADDRESS

    Die to-Adresse ist keine gültige E-Mail.

  • CMDINVALID_CCADDRESS

    Eine der cc-Adressen ist keine gültige E-Mail.

  • CMDINVALID_BCCADDRESS

    Eine der bcc-Adressen ist keine gültige E-Mail.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc und bcc haben zusammen mehr als 50 Adressen.

  • CMDINVALID_ATTACHMENT

    Der Inhalt eines Anhangs ist kein gültiges Base64.

  • CMDFILE_BLOCKED

    Eine Datei wurde von der Sicherheitsprüfung blockiert.

  • CMDATTACHMENTS_TOO_LARGE

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

  • CMDATTACHMENT_MISSING

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

  • CMDNO_CREDITS

    Das Konto hat weniger E-Mail-Credits als Empfänger (1 Credit pro Kopie).

  • CMDSENDER_NOT_FOUND

    Der Absender hinter dem Token ist nicht registriert.

  • CMDSENDER_NO_DOMAIN

    Der Absender hinter dem Token hat keine Domain.

  • CMDINTERNAL

    Serverfehler. Die Details werden nur ins Server-Log geschrieben.