---
title: "Add Domain"
method: POST
path: "/v1/orgs/{org_id}/domains"
tags: ["org-domains"]
---

# Add Domain

`POST /v1/orgs/{org_id}/domains`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/orgs/{org_id}/domains`
- Auth: none declared

Register a domain for verification (admin/owner). Refuses public webmail
domains. Returns the DNS TXT record the admin must publish to verify.

## Path parameters

- `org_id` string, required

## Request body

- DomainCreateIn
  - `domain` string, required

## Response `201`

Successful Response

- DomainOut
  - `domain` string, required
  - `verified` boolean, required
  - `txt_record_name` string, required
  - `txt_record_value` string, required
  - `verified_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sonenta/apis/sonenta-api.md) · [All operations](https://skmtc.dev/sonenta/apis/sonenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonenta/apis/sonenta-api/revisions/f853ea49fb05?raw)