---
title: "Add DNS Record"
method: POST
path: "/v1/domains/{domain}/dns-records"
tags: ["Domains"]
---

# Add DNS Record

`POST /v1/domains/{domain}/dns-records`

Add a DNS record to a domain bought in Migma, for example Google Workspace MX records, a site-verification TXT, or an A record pointing a subdomain at a server. Migma's email sending records are protected and managed automatically, duplicate SPF or DMARC records are refused, the root and www names are reserved for domain forwarding, and each domain is capped at 50 records. Returns 404 if the domain's DNS zone is not hosted by Migma. Requires API key with domain:write permission.

## Path parameters

- `domain` string, required

## Request body

- AddDnsRecordRequest
  - `name` string, required — Record name. '@' for the root domain, a label like 'mail', or a full name. Root and www are reserved for domain forwarding.
  - `content` string, required — Record value, e.g. an IP address, hostname, or TXT content
  - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' — DNS record type
  - `priority` integer — Priority for MX records

## Response `201`

DNS record created

- ApiResponseDnsRecordCreated
  - `success` boolean, required
  - `data` object, nullable
    - `record` CustomDnsRecord, required
      - `id` string, required — Record id, used to remove the record
      - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS', required — DNS record type
      - `name` string, required — Record name. '@' for the root domain, a label like 'mail', or a full name
      - `content` string, required — Record value, e.g. an IP address, hostname, or TXT content
      - `priority` number — Priority, set on MX records
      - `createdAt` string, required — When the record was added (ISO 8601)
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden - Missing required permissions or access denied
- `404` — Resource not found

---

[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/revisions/2d06ad0e0bc3/schema)