Add Domain

POST /api/organization/whitelabel/domains

Request BodyCopy Anchor Link

Example (cURL)Copy Anchor Link

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

ResponseCopy Anchor Link

{
  "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": "_verify-status.app.deinkunde.com",
    "txtValue": "xyz789-abc456"
  }
}

Add a DNS TXT record with the txtName and txtValue, then call Verify Domain.

Common errorsCopy Anchor Link

• 400 Invalid hostname when hostname format is wrong
• 400 This hostname is reserved (hostnameReserved) when the hostname is one of the platform's own hosts or anything under uptimeify.io
• 400 Wildcard domains are not supported
• 409 Hostname already exists (hostnameAlreadyExists) when your organization already has a row for this hostname

A hostname is only claimed once it is verified or active. Another organization's unverified request does not block yours, and yours does not block theirs; the claim is decided at Verify Domain. A pending request that is never verified is removed after 7 days.