Senden
E-Mails senden
Transaktionale Nachrichten, Batches, Antworten, Anhänge und gehostete Templates sicher senden.
Nachrichteninhalt
Geben Sie eine from-Identität auf einer verifizierten Domain des Workspace, mindestens einen Empfänger in to sowie HTML, Text oder ein veröffentlichtes gehostetes Template an. Bei einem Versand mit Rohinhalt kann subject fehlen; die Betreffzeile bleibt dann leer. SendHQ erzeugt bei Bedarf eine Textalternative aus dem HTML, eine selbst verfasste Alternative ist jedoch zuverlässiger.
Empfänger und Guthaben
Eine Nachricht darf insgesamt höchstens 100 Ziele in To, Cc und Bcc enthalten. Jedes Ziel verbraucht ein Guthaben für eine Empfängerzustellung. Doppelte normalisierte Empfängeradressen werden nur einmal gegen die Sperrliste geprüft, zählen aber weiterhin jeweils zu den Nachrichtenlimits.
Sichere Wiederholungsversuche
Senden Sie bei Einzel- und Batch-Übermittlungen einen stabilen Idempotency-Key mit höchstens 200 Zeichen. Wird ein Schlüssel mit identischem JSON-Payload wiederverwendet, wird die gespeicherte Antwort erneut ausgeliefert und Idempotent-Replayed: true ergänzt. Ändern Sie unter demselben Schlüssel einen Empfänger, Inhalt, Header oder Template-Daten, wird 409 zurückgegeben; eine gleichzeitige Anfrage mit diesem Schlüssel erhält ebenfalls 409, solange die erste noch aussteht.
Batch-Versand
POST /emails/batch akzeptiert bis zu 100 Nachrichtenobjekte und liefert für jede Position ein Ergebnis. Verwenden Sie für personalisierte Template-Daten separate Nachrichtenobjekte, statt ein personalisiertes Template an mehrere Empfänger zu senden.
Antworten und Threads
Setzen Sie beim Antworten reply_to_email_id. SendHQ leitet daraus Message-ID, In-Reply-To, References und die bestehende Thread-ID ab. Die vollständige Konversation rufen Sie mit GET /threads/:id ab.