# Add a custom domain

`POST /v1/domains`

**In this build:** Uses a stand-in for an external service. The record and lifecycle are real. Addresses, DNS and TLS need a deployed network.

**Scope:** `network.write`

**CLI:** `harebox domain add`

## Request: `AddDomainRequest`

| Field | Type | Notes |
|---|---|---|
| `name` (required) | `string` |  |

## Response: 201

`Domain`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `name` (required) | `string` |  |
| `status` (required) | `string` | One of: `pending_dns`, `issuing`, `active`, `failed` |
| `dns_records` | `array` |  |

Errors follow [one format](../errors.html).