---
title: ""
---

title: Create Customer Domain (Customer)
description: POST /api/customers/:customerPublicId/domains
---

# Create Customer Domain (Customer)
`POST /api/customers/:customerPublicId/domains`

Creates a customer domain for expiry monitoring.

## Request Body

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

Notes:

- `customerPublicId` should be the customer public UUID. Legacy numeric customer IDs remain supported for compatibility.
- `domainName` must be a valid domain like `deinkunde.com` (no protocol, no path).
- Creating an `active` domain may be blocked by quota limits.

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-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}'
```

## Response

Returns the newly created customer domain record.

## Common errors

- `400 Invalid Customer identifier` when `:customerPublicId` is missing/invalid
- `400 Invalid domain name...` when `domainName` is invalid
- `401 Unauthorized` when you are not logged in
- `403 Forbidden` for readonly/global supporter users, or when you cannot access the customer
- `403 Active domain limit reached...` when creating/activating would exceed your quota
- `404 Customer not found` when the customer does not exist