zones

Create a zone record

Changed on Sep 17, 2026

Creates a new zone record.

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

Request

Base URL
https://api.dnsimple.com/v2
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/:account/zones/:zone/records/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Sep 17, 2026v2faec8b49cc03 Revision changes
- info
  response property data/parent_id deprecated
Jul 11, 2025v206780be0ef17 Revision changes
- breaking
  the request property became required
- breaking
  the request property became required
- breaking
  the request property became required
- info
  the response property became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property / became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status

Operation history (4 revisions)