---
title: "Create domain [WRITE] [PRO]"
method: POST
path: "/v2/network/domain/{namespace}"
tags: ["Custom Domains"]
---

# Create domain [WRITE] [PRO]

`POST /v2/network/domain/{namespace}`

## Path parameters

- `namespace` string, required

## Request body

- DomainSpec — Custom domain registration request
  - `domain` string, required — Fully qualified domain name

## Response `200`

Domain created successfully

- DomainWithStatus — Custom domain with verification status
  - `createdAt` string, date-time, required — When the domain was registered
  - `domain` string, required — Fully qualified domain name
  - `status` DomainStatus, required — Domain provisioning status
    - `stage` 'Pending' | 'PendingChallenge' | 'ExpiredChallenge' | 'Ready' | 'Misconfigured' | 'Deleting', required

---

[API](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api.md) · [All operations](https://skmtc.net/huggingface/apis/hf-inference-endpoints-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/huggingface/hf-inference-endpoints-api/versions/52e3f4cdbf86/schema)