Add Custom Domain to Status Page

POST /api/status-pages/domains

Request BodyCopy Anchor Link

Example (cURL)Copy Anchor Link

curl -X POST "$BASE_URL/api/status-pages/domains" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "statusPageId": 1,
    "hostname": "status.deinkunde.com"
  }'

ResponseCopy Anchor Link

{
  "domain": {
    "id": 42,
    "hostname": "status.deinkunde.com",
    "status": "pending",
    "role": "status_page",
    "verificationToken": "abc123-def456-ghi789",
    "verifiedAt": null,
    "createdAt": "2026-05-01T11:00:00.000Z",
    "updatedAt": "2026-05-01T11:00:00.000Z"
  },
  "dns": {
    "txtName": "_verify-status.status.deinkunde.com",
    "txtValue": "abc123-def456-ghi789"
  }
}

Common errorsCopy Anchor Link

• 401 Unauthorized when not authenticated
• 403 Forbidden when not an admin
• 404 Not found when the status page does not exist
• 409 Conflict when the status page already has a domain (domainAlreadyExists) or your organization already has a row for this hostname (hostnameAlreadyInUse)
• 400 Bad Request when the hostname is invalid (invalidHostname) or reserved (hostnameReserved: the platform's own hosts and anything under uptimeify.io)

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