Eigene Absenderdomain
Verschicke die E-Mails deiner Organisation mit deiner eigenen Domain über die Mail-Infrastruktur von Uptimeify, ohne eigenen SMTP-Server. Enterprise-Funktion, die Uptimeify je Organisation freischaltet. Nur für Admins.
Alarm-, Report- und Statusseiten-Mails deiner Organisation können mit deiner eigenen Domain (zum Beispiel alerts@status.example.com) über den Mailanbieter von Uptimeify rausgehen. Du trägst die Domain ein, legst die DNS-Einträge an, die die API zurückgibt, und sobald sie verifiziert sind, geht die Mail mit deiner Adresse raus.
Das ist eine Enterprise-Funktion. Solange Uptimeify sie für deine Organisation nicht freigeschaltet hat, antwortet jeder Endpunkt auf dieser Seite mit 403 und data.code senderDomainNotEnabled.
Welcher Absender verwendet wird
- Dein eigener SMTP-Server, wenn einer eingerichtet ist (Organisations-SMTP). Er hat immer Vorrang.
- Deine Absenderdomain, solange ihr
statusverifiedist. - Sonst der Uptimeify-Absender. Das gilt auch, wenn eine Domain ihre Verifizierung später verliert: Die Mails kommen weiter an, dann vom Uptimeify-Absender, bis die DNS-Einträge wieder stimmen. Die Admins deiner Organisation bekommen dann einmal eine E-Mail.
Mails zwischen Uptimeify und deiner Organisation (Rechnungen, Konto-Hinweise) kommen immer von Uptimeify.
Authentifizierung und Rechte
Rolle admin. Gesperrt für API-Tokens mit Scopes, kundengebundene Tokens und Agenten-Tokens: nimm ein Token ohne Scopes oder eine Sitzung.
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"Das Absenderdomain-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
domain | string | Die Absenderdomain, kleingeschrieben. |
fromEmail | string | Absenderadresse, liegt immer auf domain. |
fromName | string | Anzeigename des Absenders. |
replyTo | string|null | Antwortadresse. |
status | string | pending (DNS-Einträge noch nicht verifiziert), verified (Mails gehen mit dieser Domain raus), failed (war verifiziert, ist es nicht mehr). |
dnsRecords | array | Die anzulegenden Einträge: type, hostname, fqdn, content, status (active, pending, failed), purpose, required (für die Verifizierung nötig). |
lastCheckedAt | string|null | Letzte Prüfung, ISO 8601 UTC. |
verifiedAt | string|null | Wann die Domain zuletzt verifiziert wurde. |
lastError | string|null | Was die letzte Prüfung gemeldet hat, solange nicht verifiziert. |
createdAt, updatedAt | string | ISO 8601 UTC. |
Absenderdomain abrufen
GET /api/organization/sender-domain
curl "$BASE_URL/api/organization/sender-domain" -H "Authorization: Bearer $TOKEN"{
"domain": "status.example.com",
"fromEmail": "alerts@status.example.com",
"fromName": "Example Alerts",
"replyTo": null,
"status": "pending",
"dnsRecords": [
{
"type": "CNAME",
"hostname": "lm1._domainkey",
"fqdn": "lm1._domainkey.status.example.com",
"content": "lm1._domainkey.example.lmta.net",
"status": "pending",
"purpose": "dkim_primary",
"required": true
}
],
"lastCheckedAt": null,
"verifiedAt": null,
"lastError": null,
"createdAt": "2026-11-09T10:00:00.000Z",
"updatedAt": "2026-11-09T10:00:00.000Z"
}404 mit data.code senderDomainNotConfigured, solange keine Domain eingetragen ist.
Absenderdomain festlegen
PUT /api/organization/sender-domain
Trägt die Domain ein oder ändert sie. Eine neue Domain startet als pending mit neuen dnsRecords; eine vorherige Domain wird entfernt. Dieselbe Domain noch einmal zu schicken ändert nur die Absenderfelder und behält die Verifizierung.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
domain | string | ja | Ein Domainname. Empfohlen ist eine Subdomain wie status.example.com. Wird kleingeschrieben, ein Punkt am Ende fällt weg. |
fromEmail | string | ja | Absenderadresse. Muss genau auf domain liegen (alerts@status.example.com, nicht alerts@example.com). |
fromName | string | ja | Anzeigename, 1-200 Zeichen. |
replyTo | string|null | nein | Antwortadresse; null leert sie. |
Unbekannte Felder werden abgewiesen.
curl -X PUT "$BASE_URL/api/organization/sender-domain" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "domain": "status.example.com", "fromEmail": "alerts@status.example.com", "fromName": "Example Alerts" }'Antwortet 200 mit dem Absenderdomain-Objekt.
DNS-Einträge jetzt prüfen
POST /api/organization/sender-domain/verify
Prüft die DNS-Einträge sofort und antwortet 200 mit dem aktualisierten Absenderdomain-Objekt. Uptimeify prüft außerdem von selbst alle sechs Stunden.
curl -X POST "$BASE_URL/api/organization/sender-domain/verify" -H "Authorization: Bearer $TOKEN"Absenderdomain entfernen
DELETE /api/organization/sender-domain
Entfernt die Domain. Die Mails gehen sofort wieder vom Uptimeify-Absender raus. Antwortet 204 ohne Body; ein zweiter Aufruf antwortet 404 senderDomainNotConfigured.
curl -X DELETE "$BASE_URL/api/organization/sender-domain" -H "Authorization: Bearer $TOKEN"Häufige Fehler
400 invalidRequestBody: kein Domainname,fromEmailliegt nicht aufdomain, oder ein unbekanntes Feld (data.issuesnennt das Feld)400 senderDomainReserved: eine Uptimeify-Domain oder eine ihrer Subdomains403 forbidden: kein Admin403 senderDomainNotEnabled: die Funktion ist für deine Organisation nicht freigeschaltet404 senderDomainNotConfigured: keine Absenderdomain eingetragen (GET, verify, DELETE)409 senderDomainTaken: die Domain nutzt schon eine andere Organisation, oder sie ist beim Mailanbieter bereits registriert502 senderDomainProviderError: der Mailanbieter hat die Anfrage nicht angenommen; versuch es später noch einmal503 senderDomainUnavailable: Absenderdomains sind vorübergehend nicht verfügbar
SMTP-Verbindung testen
Testet die SMTP-Konfiguration durch Versand einer Test-E-Mail. Alle Parameter sind optional. Wenn weggelassen, werden die gespeicherten Konfigurationswerte verwendet. So kannst du neue Zugangsdaten testen, bevor du sie speicherst. Nur für Admins.
Statusseiten
Statusseiten ermöglichen es, den Betriebsstatus überwachter Dienste für Kunden oder die Öffentlichkeit transparent darzustellen.