> For the complete documentation index, see [llms.txt](https://developers.docstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.docstudio.com/api-documentation/api-methods/account-domains/add-account-domain.md).

# Add Account Domain

Use this endpoint to add a new domain if domain adding is enabled. The domain must be resolvable and must not be assigned to another account.

<table data-header-hidden><thead><tr><th width="329"></th><th></th></tr></thead><tbody><tr><td>Endpoint</td><td></td></tr><tr><td>Method</td><td>POST</td></tr><tr><td>Request URL</td><td><code>/api/v1/account/{accountUuid}/domain</code></td></tr><tr><td><strong>Headers</strong></td><td></td></tr><tr><td>Authorization *</td><td>Bearer TOKEN</td></tr><tr><td>Content-Type</td><td>application/json</td></tr><tr><td><strong>Request</strong></td><td></td></tr><tr><td>accountUuid *</td><td>Target account UUID</td></tr><tr><td>Body</td><td><pre><code>{
    "domain": "string"
}
</code></pre></td></tr></tbody></table>

### **Request example**

```json
{
  "domain": "google.com"
}
```

### **Response example**

```json
{
    "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "accountUuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "domain": "google.com",
    "status": "UNVERIFIED"
}
```

The created domain starts with the `UNVERIFIED` status. Continue with [Verify Account Domain](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-domains/verify-account-domain).

### **Response status codes**

| Code | Description              |
| ---- | ------------------------ |
| 200  | Success                  |
| 400  | Bad request              |
| 401  | Not authorized           |
| 403  | Forbidden                |
| 409  | Domain is already in use |

### Related topics

* [Verify Account Domain](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-domains/verify-account-domain)
* [Confirm Account Domain Verification](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-domains/confirm-account-domain-verification)
* [Domain Statuses & Verify Methods](https://support.docstudio.com/docstudio-docs/docstudio-for-developers/api-documentation/api-methods/account-domains/domain-statuses-and-verify-methods)
