---
title: "Add Domain"
method: POST
path: "/v1/domains"
tags: ["Domains"]
---

# Add Domain

`POST /v1/domains`

Add a new sending domain. Returns DNS records that must be configured for verification. Requires API key with domain:write.

## Request body

- AddDomainRequest
  - `domain` string, required — Domain name (e.g., mail.example.com)

## Response `200`

Domain added

- ApiResponseDomain
  - `success` boolean, required
  - `data` object, nullable
    - `_id` string
    - `domain` string
    - `region` 'us-east-1' | 'eu-west-1' | 'us-east-2' — AWS region the domain sends from. Automatically assigned at creation.
    - `regionName` string
    - `status` 'pending' | 'verifying' | 'verified' | 'degraded' | 'failed' | 'suspended'
    - `dkimStatus` 'SUCCESS' | 'PENDING' | 'FAILED' | 'NOT_STARTED'
    - `mailFromDomain` string
    - `mailFromStatus` 'SUCCESS' | 'PENDING' | 'FAILED'
    - `dnsRecords` DnsRecord[]
      - `type` 'CNAME' | 'TXT' | 'MX'
      - `name` string
      - `value` string
      - `priority` integer
      - `status` 'pending' | 'verified' | 'failed'
    - `ownershipVerified` boolean
    - `openTracking` boolean
    - `clickTracking` boolean
    - `brandedTracking` boolean
    - `createdAt` string, date-time
    - `verifiedAt` string, date-time, nullable
    - `isManagedDomain` boolean
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/versions/3f3dba69574b/schema)