v26

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1247150179.9 KB

dns-records

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.

post/domains/{name}/dns/records

Path parameters

namestring required

Query parameters

$previewboolean required

Request body

subNamestring

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

DNS record type. Case-insensitive — values are uppercased automatically.

valuesstring[] required

ttlnumber required

$upsert'REPLACE' | 'APPEND' | 'DISALLOWED'

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.

$forceCompatibilityboolean required

Response

DNS record creation operation created

@type'unstoppabledomains.com/partner.v3.DomainDnsRecordOperationResult' required

Example response

{
  "operation": {
    "id": "op-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "dependencies": [
      {
        "id": "plop_abc12345-1234-1234-1234-abc123456789",
        "parameters": {
          "owner": {
            "id": "con_abc12345-1234-1234-1234-abc123456789"
          },
          "contacts": {
            "admin": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            },
            "billing": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            },
            "tech": {
              "id": "con_abc12345-1234-1234-1234-abc123456789"
            }
          },
          "period": 1
        }
      }
    ]
  }
}