Erster Versand per SMTP

Sie brauchen

• Ein Projekt mit verbundener Domain und freigegebener Absenderadresse.
• Einen SMTP-Zugang für dieses Projekt: Benutzername und Passwort, das einmal angezeigt wird. SMTP-Zugänge können nur senden, nicht die API aufrufen.
• Den SMTP-Hostnamen von der SMTP-Seite des Projekts.

Einstellungen

Einstellung	Wert
Host	steht im Dashboard
Port	587 mit STARTTLS oder 465 mit implizitem TLS
Verschlüsselung	Pflicht, TLS 1.2 oder neuer; Zertifikatsprüfung eingeschaltet lassen
Authentifizierung	PLAIN oder LOGIN, nur nach TLS
Absender (From)	muss exakt Ihrer freigegebenen Absenderadresse entsprechen

Beispiel mit Nodemailer

import nodemailer from 'nodemailer';

const transport = nodemailer.createTransport({
  host: process.env.WENEED_SMTP_HOST,
  port: 587,
  secure: false, // auf 587 wird STARTTLS ausgehandelt; für implizites TLS 465 mit secure: true
  requireTLS: true,
  auth: { user: process.env.WENEED_SMTP_USER, pass: process.env.WENEED_SMTP_PASS },
});

await transport.sendMail({
  from: 'Ihre App <hallo@ihredomain.at>',
  to: 'person@example.com',
  subject: 'Willkommen',
  text: 'Danke für Ihre Anmeldung.',
  headers: { 'X-Email-Idempotency-Key': 'signup-7f3c2a91-welcome' },
});

Die Antwort 250 heißt gespeichert und eingereiht, nicht zugestellt.

Duplikate vermeiden

Gewöhnliche Mail-Clients wiederholen selbstständig. Bricht die Verbindung nach dem Senden, aber vor dem 250 ab, kann eine Wiederholung eine zweite Nachricht erzeugen. Setzen Sie den Header X-Email-Idempotency-Key (16 bis 128 druckbare Zeichen), damit eine Wiederholung derselben Nachricht erkannt wird. Siehe Wiederholungen und Duplikate.

Was SMTP nicht kann

Eine Empfängerin oder ein Empfänger pro Nachricht, keine Anhänge, kein Gesendet-Ordner und kein Postfach. Alle Grenzen stehen in der SMTP-Referenz.