---
title: "Domain hinzufügen"
description: "Fügt eine eigene Domain für White-Label hinzu. Erstellt einen ausstehenden DNS-Verifizierungseintrag. Die erste Domain wird automatisch als primär gesetzt. Erfordert die Admin-Rolle."
---

`POST /api/organization/whitelabel/domains`

## Anfrage (Request Body)

| Feld | Typ | Pflicht | Beschreibung |
|-------|------|----------|-------------|
| `hostname` | string | Ja | Hostname der eigenen Domain (3-253 Zeichen). Keine Wildcards. |

## Beispiel (cURL)

```bash
curl -X POST "$BASE_URL/api/organization/whitelabel/domains" \
  -H "Cookie: $SESSION_COOKIE" \
  -H "Content-Type: application/json" \
  -d '{
    "hostname": "app.deinkunde.com"
  }'
```

## Antwort (Response)

```json
{
  "domain": {
    "id": 2,
    "hostname": "app.deinkunde.com",
    "status": "pending",
    "role": "app",
    "isPrimary": false,
    "verificationToken": "xyz789-abc456",
    "verifiedAt": null,
    "createdAt": "2026-04-15T12:00:00.000Z",
    "updatedAt": "2026-04-15T12:00:00.000Z"
  },
  "dns": {
    "txtName": "_uptimeify-verify.app.deinkunde.com",
    "txtValue": "xyz789-abc456"
  }
}
```

Lege einen DNS-TXT-Eintrag mit `txtName` und `txtValue` an und rufe anschließend [Domain verifizieren](./verify-domain) auf.

## Häufige Fehler

- `400 Invalid hostname` wenn das Hostname-Format falsch ist
- `400 This hostname is reserved` wenn der Hostname mit der Hauptplattform übereinstimmt
- `400 Wildcard domains are not supported`
- `409 Hostname already exists`