---
title: "Create a zone record"
method: POST
path: "/{account}/zones/{zone}/records"
tags: ["zones"]
---

# Create a zone record

`POST /{account}/zones/{zone}/records`

Creates a new zone record.

## Path parameters

- `account` integer, required
- `zone` string, required

## Request body

- object
  - `name` string, 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.
  - `content` string, required
  - `ttl` integer — The Time To Live (TTL) value for the entry, in seconds.
  - `priority` integer
  - `regions` ZoneRecordRegion[]
  - `integrated_zones` integer[]

## Response `201`

Successfully created zone record.

- object
  - `data` ZoneRecord, required — A single DNS record in a zone.
    - `id` integer, required — The unique identifier for the record.
    - `zone_id` string, required — The unique identifier of the zone this record belongs to
    - `parent_id` integer, nullable, required — If present represents the zone record this record relates to. The parent record is the master record, when the parent is updated or deleted the related record is also updated or deleted. An example of child record is the TXT descriptive record created for an ALIAS record.
    - `name` string, required — The name of the record (e.g., "www" for www.example.com).
    - `content` string, required — The content/value of the record (e.g., IP address for A records, hostname for CNAME records).
    - `ttl` integer, required — The Time To Live (TTL) value for the entry, in seconds.
    - `priority` integer, nullable, required — The priority value for MX and SRV records. Lower values have higher priority.
    - `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.
    - `regions` ZoneRecordRegion[], required — The regions where this record is active. If empty, the record is active in all regions.
    - `system_record` boolean, required — Returns true if a record is a system generated record and thus is not modifiable.
    - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
    - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.

## Other responses

- `400` — A required parameter is missing or the request is invalid.
- `404` — The requested resource doesn't exist.

---

[API](https://skmtc.net/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.net/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)