---
title: ""
---

title: Kunden-Domain erstellen (Kunde)
description: POST /api/customers/:customerPublicId/domains
---

# Kunden-Domain erstellen (Kunde)
`POST /api/customers/:customerPublicId/domains`

Erstellt eine Kunden-Domain für die Ablauf-Überwachung.

## Request Body

```json
{
  "domainName": "deinkunde.com",
  "label": "Main Domain",
  "status": "active",
  "expiryWarningDays": 30,
  "expiryErrorDays": 7
}
```

Hinweise:

- `customerPublicId` sollte die Public-ID des Kunden als UUID sein. Legacy-numerische Kunden-IDs bleiben aus Kompatibilitätsgründen weiter unterstützt.
- `domainName` muss eine gültige Domain wie `deinkunde.com` sein (kein Protokoll, kein Pfad).
- Das Erstellen einer `active` Domain kann durch Quota-Limits blockiert werden.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X POST "$BASE_URL/api/customers/6bfec6f6-245a-47ce-843b-157d97d56f88/domains" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domainName":"deinkunde.com","label":"Main Domain","status":"active","expiryWarningDays":30,"expiryErrorDays":7}'
```

## Antwort

Gibt den neu erstellten Kunden-Domain-Record zurück.

## Häufige Fehler

- `400 Invalid Customer identifier` wenn `:customerPublicId` fehlt/ungültig ist
- `400 Invalid domain name...` wenn `domainName` ungültig ist
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` für Readonly/Global-Supporter-User, oder wenn du keinen Zugriff auf den Kunden hast
- `403 Active domain limit reached...` wenn das Erstellen/Aktivieren dein Quota-Limit überschreiten würde
- `404 Customer not found` wenn der Kunde nicht existiert