---
title: "Add DNS Record"
method: PUT
path: "/dnszone/{zoneId}/records"
tags: ["DNS Zone"]
---

# Add DNS Record

`PUT /dnszone/{zoneId}/records`

## Request

- Base URL: `https://api.bunny.net`
- URL: `https://api.bunny.net/dnszone/{zoneId}/records`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/bunny-net-api/docs/dnszone/:zoneId/records/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `zoneId` integer, required

## Request body

- AddDnsRecordModel
  - `Type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15: 0 = A 1 = AAAA 2 = CNAME 3 = TXT 4 = MX 5 = Redirect 6 = Flatten 7 = Pull Zone 8 = SRV 9 = CAA 10 = PTR 11 = Script 12 = NS 13 = SVCB 14 = HTTPS 15 = TLSA
  - `Ttl` integer, nullable
  - `Value` string, nullable
  - `Name` string, nullable
  - `Weight` integer, nullable
  - `Priority` integer, nullable
  - `Flags` integer, nullable
  - `Tag` string, nullable
  - `Port` integer, nullable
  - `PullZoneId` integer, nullable
  - `ScriptId` integer, nullable
  - `Accelerated` boolean, nullable
  - `MonitorType` 0 | 1 | 2 | 3: 0 = None 1 = Ping 2 = HTTP 3 = Monitor
  - `GeolocationLatitude` number, double, nullable
  - `GeolocationLongitude` number, double, nullable
  - `LatencyZone` string, nullable
  - `SmartRoutingType` 0 | 1 | 2: 0 = None 1 = Latency 2 = Geolocation
  - `Disabled` boolean, nullable
  - `EnviromentalVariables` DnsRecordEnviromentalVariableModel[], nullable
    - `Name` string, nullable
    - `Value` string, nullable
  - `Comment` string, nullable
  - `AutoSslIssuance` boolean, nullable

## Response `201`

The DNS record was successfully added.

- DnsRecordModel
  - `Id` integer
  - `Type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15: 0 = A 1 = AAAA 2 = CNAME 3 = TXT 4 = MX 5 = Redirect 6 = Flatten 7 = Pull Zone 8 = SRV 9 = CAA 10 = PTR 11 = Script 12 = NS 13 = SVCB 14 = HTTPS 15 = TLSA
  - `Ttl` integer
  - `Value` string, nullable
  - `Name` string, nullable
  - `Weight` integer
  - `Priority` integer
  - `Port` integer
  - `Flags` integer
  - `Tag` string, nullable
  - `Accelerated` boolean
  - `AcceleratedPullZoneId` integer
  - `LinkName` string, nullable
  - `IPGeoLocationInfo` GeoDnsLocationModel
    - `CountryCode` string, nullable: The ISO country code of the location
    - `Country` string, nullable: The name of the country of the location
    - `ASN` integer: The ASN of the IP organization
    - `OrganizationName` string, nullable: The mame of the organization that owns the IP
    - `City` string, nullable: The name of the city of the location
  - `GeolocationInfo` DnsRecordGeoLocationInfo
    - `Country` string, nullable
    - `City` string, nullable
    - `Latitude` number, double
    - `Longitude` number, double
  - `MonitorStatus` 0 | 1 | 2: 0 = Unknown 1 = Online 2 = Offline
  - `MonitorType` 0 | 1 | 2 | 3: 0 = None 1 = Ping 2 = HTTP 3 = Monitor
  - `GeolocationLatitude` number, double
  - `GeolocationLongitude` number, double
  - `EnviromentalVariables` DnsRecordEnviromentalVariableModel[], nullable
    - `Name` string, nullable
    - `Value` string, nullable
  - `LatencyZone` string, nullable
  - `SmartRoutingType` 0 | 1 | 2: 0 = None 1 = Latency 2 = Geolocation
  - `Disabled` boolean
  - `Comment` string, nullable
  - `AutoSslIssuance` boolean
  - `AccelerationStatus` 0 | 1 | 2 | 3 | 4: 0 = None 1 = Pending 2 = Processing 3 = Completed 4 = Failed

## Other responses

- `400`: Failed adding the DNS record. Model validation failed.
- `401`: The request authorization failed
- `404`: The DNS Zone with the requested ID does not exist.
- `500`: Internal Server Error

## Changes

- **2026-11-12** `2b06f94dbfbf`: 10 breaking, 31 info
  - added `#/components/schemas/AcceleratedStatus` to the `AccelerationStatus` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/DnsMonitoringStatus` to the `MonitorStatus` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/DnsMonitoringType` to the `MonitorType` response property `oneOf` list for the response status `201`
  - added `#/components/schemas/DnsRecordTypes` to the `Type` response property `oneOf` list for the response status `201`
  - …37 more

[Operation history](https://skmtc.dev/bunny/apis/bunny-net-api/changes/dnszone/:zoneId/records/put.md)

---

[API](https://skmtc.dev/bunny/apis/bunny-net-api.md) - [All operations](https://skmtc.dev/bunny/apis/bunny-net-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/bunny-net-api/revisions/2b06f94dbfbf?raw)