# Create domain

**POST /api/domains**

Create a new domain with the given data. The maximum domain number is 1, once created, can not be modified, you'll have to delete and recreate one.


## Servers
- Logto endpoint address.: https://[tenant_id].logto.app (Logto endpoint address.)


## Authentication methods
- O auth2


## Parameters



### Body: application/json (object)

- **domain** (string)
  The domain name, e.g. `example.com`.


## Responses
### 201
The domain was created successfully.

#### Body: application/json (object)
- **id** (string)

- **domain** (string)

- **status** (string)

- **errorMessage** (string | null)

- **dnsRecords** (array[object])

- **createdAt** (number)


### 400
Bad Request

### 401
Unauthorized

### 403
Forbidden

### 422
Validation error. Please check the request body.


[Powered by Bump.sh](https://bump.sh)