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-edge.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"
  }
}

Changes

Changed in 3 of the 54 revisions of this API.21120

Jul 11, 2025v206780be0ef17316See the full diff
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  the request property became required
  request-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property / became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
Aug 11, 2023v298a794a9b1911See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Jul 18, 2023v2c8591dcf8c291813See the full diff
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property / became nullable for the status
  response-property-became-nullable
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property / became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ●
  removed the request property
  request-property-removed
- ○
  the request property became optional
  request-property-became-optional
- ○
  the request property became optional
  request-property-became-optional
- ○
  the request property became optional
  request-property-became-optional
This revision also has 25 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history