Skip to Content
Uptimeify Docs

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

  1. Dein eigener SMTP-Server, wenn einer eingerichtet ist (Organisations-SMTP). Er hat immer Vorrang.
  2. Deine Absenderdomain, solange ihr status verified ist.
  3. 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

FeldTypBeschreibung
domainstringDie Absenderdomain, kleingeschrieben.
fromEmailstringAbsenderadresse, liegt immer auf domain.
fromNamestringAnzeigename des Absenders.
replyTostring|nullAntwortadresse.
statusstringpending (DNS-Einträge noch nicht verifiziert), verified (Mails gehen mit dieser Domain raus), failed (war verifiziert, ist es nicht mehr).
dnsRecordsarrayDie anzulegenden Einträge: type, hostname, fqdn, content, status (active, pending, failed), purpose, required (für die Verifizierung nötig).
lastCheckedAtstring|nullLetzte Prüfung, ISO 8601 UTC.
verifiedAtstring|nullWann die Domain zuletzt verifiziert wurde.
lastErrorstring|nullWas die letzte Prüfung gemeldet hat, solange nicht verifiziert.
createdAt, updatedAtstringISO 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.

FeldTypPflichtBeschreibung
domainstringjaEin Domainname. Empfohlen ist eine Subdomain wie status.example.com. Wird kleingeschrieben, ein Punkt am Ende fällt weg.
fromEmailstringjaAbsenderadresse. Muss genau auf domain liegen (alerts@status.example.com, nicht alerts@example.com).
fromNamestringjaAnzeigename, 1-200 Zeichen.
replyTostring|nullneinAntwortadresse; 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, fromEmail liegt nicht auf domain, oder ein unbekanntes Feld (data.issues nennt das Feld)
  • 400 senderDomainReserved: eine Uptimeify-Domain oder eine ihrer Subdomains
  • 403 forbidden: kein Admin
  • 403 senderDomainNotEnabled: die Funktion ist für deine Organisation nicht freigeschaltet
  • 404 senderDomainNotConfigured: keine Absenderdomain eingetragen (GET, verify, DELETE)
  • 409 senderDomainTaken: die Domain nutzt schon eine andere Organisation, oder sie ist beim Mailanbieter bereits registriert
  • 502 senderDomainProviderError: der Mailanbieter hat die Anfrage nicht angenommen; versuch es später noch einmal
  • 503 senderDomainUnavailable: Absenderdomains sind vorübergehend nicht verfügbar

Auf dieser Seite