---
title: "Eigene Absenderdomain"
description: "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](/api/organization-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.

```bash
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`

```bash
curl "$BASE_URL/api/organization/sender-domain" -H "Authorization: Bearer $TOKEN"
```

```json
{
  "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.

```bash
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.

```bash
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`.

```bash
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
