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.

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

Alles, 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.

i

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.

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

  • send_atstringerforderlich

    RFC 3339, YYYY-MM-DD oder Epoch ms. Mindestens 1 Minute ab jetzt und höchstens 1 Jahr.

  • modestringoptional

    new (Standard), reply oder forward.

  • idstringoptional

    Die Originalnachricht, für reply und forward.

  • tostring | string[]optional

    Empfänger. Pflicht bei new und forward. Bei new kann es eine Liste mit bis zu 30 sein (kostenpflichtige Tarife).

  • ccstring[]optional

    Sichtbare Kopien.

  • bccstring[]optional

    Verdeckte Kopien.

  • subjectstringoptional

    Erforderlich für new. Reply und forward verwenden standardmäßig Re: / Fwd: Original.

  • htmlstringoptional

    HTML-Inhalt. Oder text oder template_id.

  • template_idstringoptional

    Füllt den Inhalt (und den Betreff einer neuen E-Mail) aus einem Template.

  • followup_after_hoursnumberoptional

    Erinnert Sie, wenn so viele Stunden nach dem Versand niemand antwortet.

  • scheduled_idstringoptional

    Neu planen: Die alte geplante E-Mail wird ersetzt.

  • attachmentsobject[]optional

    Anzuhängende Dateien: [{ file_name, content, content_type }], content in Base64. Bis zu 20 Dateien und insgesamt 25 MB. Jede Datei wird geprüft; eine gefährliche schlägt mit FILE_BLOCKED fehl.

  • compose_uidstringoptional

    Anhänge, die Sie zuvor mit upload_attachment hochgeladen haben.

  • attachment_idsstring[]optional

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

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

  • best_timebooleanoptional

    Sendet jeder Person zu der Uhrzeit, zu der sie normalerweise öffnet oder klickt, am Tag von send_at. Erfordert audience und mode: new. send_at ist 00:00 dieses Tages in Ihrer Zeitzone, als UTC.

  • best_fallback_atstring | numberoptional

    Uhrzeit für Personen ohne Verlauf (RFC 3339 oder Epoch-ms). Muss am selben Tag wie send_at liegen.

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_id

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

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

  • CMDBEST_TIME_NEEDS_AUDIENCE

    `best_time` erfordert ein `audience` und `mode: new`.

  • 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_TIME

    send_at fehlt, liegt weniger als 1 Minute oder mehr als 1 Jahr entfernt.

  • CMDINVALID_RECIPIENT

    Der Empfänger fehlt oder ist keine gültige E-Mail.

  • CMDMISSING_SUBJECT

    Eine neue E-Mail braucht einen Betreff.

  • CMDMISSING_TARGET

    Reply und forward brauchen die Original-E-Mail, und diese muss noch existieren.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

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

  • CMDINTERNAL

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