Sign in

v1

latestOpenAPI 3.1.12026-07-17111158225.7 KB
zones

Create a zone record

Creates a new zone record.

post/{account}/zones/{zone}/records

Path parameters

accountinteger required

The account id

zonestring required

The zone name

Request body

namestring required
type'A' | 'AAAA' | 'ALIAS' | 'CAA' | 'CNAME' | 'DNSKEY' | 'DS' | 'HINFO' | 'MX' | 'NAPTR' | 'NS' | 'POOL' | 'PTR' | 'SOA' | 'SPF' | 'SRV' | 'SSHFP' | 'TXT' | 'URL' required

The type of DNS record. Supported DNS record types are listed below. Note that some record types may only be available on specific plans.

contentstring required
ttlinteger

The Time To Live (TTL) value for the entry, in seconds.

priorityinteger
regionsZoneRecordRegion[]
integrated_zonesinteger[]

Example request

{
  "name": "",
  "type": "MX",
  "content": "mxa.example.com",
  "ttl": 600,
  "priority": 10,
  "regions": [
    "SV1",
    "IAD"
  ]
}

Response

Successfully created zone record.

Example response

{
  "data": {
    "id": 1,
    "zone_id": "example.com",
    "parent_id": null,
    "name": "",
    "content": "ns1.dnsimple.com admin.dnsimple.com 1458642070 86400 7200 604800 300",
    "ttl": 3600,
    "priority": null,
    "type": "SOA",
    "regions": [
      "global"
    ],
    "system_record": true,
    "created_at": "2016-03-22T10:20:53Z",
    "updated_at": "2016-10-05T09:26:38Z"
  }
}