SMTP-Verbindung testen

POST /api/organization/smtp/test

Der Test aktualisiert außerdem die Felder lastTestedAt, lastTestStatus und lastTestError der SMTP-Konfiguration.

Anfrage (Request Body): alle optionalAnkerlink kopieren

Beispiel (cURL): Mit gespeicherter KonfigurationAnkerlink kopieren

curl -X POST "$BASE_URL/api/organization/smtp/test" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Content-Type: application/json" \
  -d '{}'

Beispiel (cURL): Neue Zugangsdaten testenAnkerlink kopieren

curl -X POST "$BASE_URL/api/organization/smtp/test" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Content-Type: application/json" \
  -d '{
    "host": "smtp.deinkunde.com",
    "port": 587,
    "tlsMode": "starttls",
    "username": "alerts@deinkunde.com",
    "password": "secret-password",
    "fromName": "Uptimeify Alerts",
    "fromEmail": "alerts@deinkunde.com",
    "toEmail": "admin@deinkunde.com"
  }'

Antwort (Erfolg)Ankerlink kopieren

{
  "success": true,
  "messageId": "<abc123@mail.deinkunde.com>"
}

Häufige FehlerAnkerlink kopieren

• 400 Password must be re-entered when the SMTP host changes (data.code: smtpPasswordRequiredForNewHost) wenn der Request einen host schickt, der vom gespeicherten abweicht, aber kein password: das gespeicherte Passwort geht nur an den gespeicherten Host

• 400 Missing recipient email (toEmail) wenn kein Empfänger angegeben ist und der Benutzer keine E-Mail hat

• 400 SMTP config incomplete (host/port required) wenn Host oder Port fehlt

• 400 SMTP config incomplete (username required) wenn ein Benutzername benötigt wird, aber fehlt

• 400 SMTP password missing (username is set) wenn ein Passwort benötigt wird, aber fehlt

• 400 SMTP config incomplete (fromEmail required) wenn fromEmail fehlt

• 403 Forbidden wenn du kein Admin bist

• 502 Failed to send SMTP test email wenn die SMTP-Verbindung fehlschlägt