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

# Add DNS record

`POST /v1/domains/{domain_id}/dns/records`

## Request

- Base URL: `https://developers.servera.co.uk`
- URL: `https://developers.servera.co.uk/v1/domains/{domain_id}/dns/records`
- Auth: HTTP bearer

Add a DNS record to a domain you own (PowerDNS-hosted zones).

## Path parameters

- `domain_id` integer, required

## Request body

- DnsRecordCreate
  - `name` string, required: Record name/subdomain, or '@' for the apex. Letters, digits and '-', '_', '.', '*' only.
  - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'SRV' | 'CAA', required
  - `content` string, required
  - `ttl` integer
  - `priority` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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