---
title: ""
---

title: Kunden-IP (für Kunde) erstellen
description: POST /api/customers/:customerPublicId/ips
---

# Kunden-IP (für Kunde) erstellen
`POST /api/customers/:customerPublicId/ips`

Erstellt eine neue Kunden-IP für DNSBL-Überwachung.

## Anfrage (Request Body)

```json
{
  "ipAddress": "203.0.113.10",
  "label": "Mail Server",
  "ipFamily": "v4",
  "status": "active"
}
```

Hinweise:

- `customerPublicId` sollte die Public-ID des Kunden als UUID sein. Legacy-numerische Kunden-IDs bleiben aus Kompatibilitätsgründen weiter unterstützt.
- `ipFamily` ist optional (wird sonst aus der IP abgeleitet).
- Wenn `ipFamily` gesetzt ist, muss es zur IP-Version passen.
- Das Erstellen einer `active` IP kann wegen Quota-Limits abgelehnt 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/ips" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ipAddress":"203.0.113.10","label":"Mail Server","status":"active"}'
```

## Häufige Fehler

- `400 Invalid Customer identifier` wenn `:customerPublicId` fehlt/ungültig ist
- `400 Invalid IP address` wenn `ipAddress` ungültig ist
- `400 IP family mismatch...` wenn `ipFamily` nicht zur IP passt
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` für Readonly/Global-Supporter oder bei fehlendem Zugriff
- `403 Active IP limit reached...` wenn Erstellung/Aktivierung dein Quota überschreitet
- `404 Customer not found` wenn der Kunde nicht existiert
- `409 IP already exists for this customer` wenn die IP bereits existiert

## Antwort (Response)

Gibt das erstellte Kunden-IP-Objekt zurück. Siehe [Fehlerliste](/de/api/error-codes-and-known-pitfalls) für Fehlerantworten.