# Create a DNS record

Create a new DNS record for the specified domain. Supports all standard DNS record types. Use $preview=true to validate the request without creating the record.

The $upsert option controls behavior when a matching record already exists: REPLACE overwrites, APPEND adds values, DISALLOWED rejects the request.

Endpoint: POST /domains/{name}/dns/records
Version: 1.0.0
Security: bearer

## Path parameters:

  - `name` (string, required)

## Query parameters:

  - `$preview` (boolean, required)

## Request fields (application/json):

  - `subName` (string)
    Subdomain name (e.g., "www", "mail"). Omit or leave empty for the apex domain.

  - `type` (string, required)
    DNS record type. Case-insensitive — values are uppercased automatically.
    Enum: "A", "AAAA", "ALIAS", "CAA", "CNAME", "DNSKEY", "DS", "HTTPS", "IPSECKEY", "MX", "NAPTR", "NS", "PTR", "SOA", "SPF", "SRV", "SSHFP", "SVCB", "TLSA", "TXT"

  - `values` (array, required)

  - `ttl` (number, required)

  - `$upsert` (string)
    Upsert mode for handling conflicts with existing records. Case-insensitive. REPLACE: overwrite existing record values. APPEND: add values to existing record. DISALLOWED: fail if record exists.
    Enum: "REPLACE", "APPEND", "DISALLOWED"

  - `$forceCompatibility` (boolean, required)

## Response 201 fields (application/json):

  - `@type` (number, required)

  - `operation` (object, required)

  - `operation.id` (string, required)
    Operation ID
    Example: "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `operation.status` (string, required)
    Enum: "PREVIEW", "QUEUED", "PROCESSING", "FAILED", "COMPLETED", "CANCELLED", "AWAITING_UPDATES"

  - `operation.type` (string, required)
    Enum: "ADMIN_GENERIC", "DOMAIN_ADMIN_UPDATE", "DOMAIN_RENEW", "ACCOUNT_UPDATE", "DOMAIN_DNS_RECORD_CREATE", "DOMAIN_DNS_RECORD_UPDATE", "DOMAIN_DNS_RECORD_DELETE", "DOMAIN_DNS_RECORD_BATCH", "DOMAIN_DNS_SECURITY_ENABLE", "DOMAIN_DNS_SECURITY_DELETE", "DOMAIN_DNS_NAME_SERVER_UPDATE", "DOMAIN_HOSTING_UPDATE", "DOMAIN_HOSTING_DISABLE", "DOMAIN_TRANSFER_OUT", "DOMAIN_TRANSFER_OUT_TOGGLE", "DOMAIN_FLAGS_UPDATE", "DOMAIN_CONTACTS_UPDATE", "CONTACT_CREATE", "DOMAIN_SUGGESTION_CREATE", "DOMAIN_SUGGESTION_REFRESH"

  - `operation.domain` (string)

  - `operation.createdAtTimestamp` (number, required)

  - `operation.lastUpdatedTimestamp` (number, required)

  - `operation.validUntilTimestamp` (number)

  - `operation.dependencies` (array, required)
    List of platform operation dependencies that make up this operation