---
title: "Create a DNS Zone"
method: POST
path: "/workspace/dns/zones"
tags: ["DNS - Zones"]
---

# Create a DNS Zone

`POST /workspace/dns/zones`

Create a new DNS Zone for your account.

## Request body

- ZoneRequest
  - `name` string, required
  - `domain` string, required
  - `active` boolean, required

## Response `201`

DNS zone created successfully.

- ZoneResponse
  - `state` string
  - `data` Zone, required
    - `id` integer, required
    - `name` string, required
    - `domain` string, required
    - `active` boolean, required
    - `nameservers` string[], required
    - `product_version` string, required

## Other responses

- `400` — Validation Error
- `401` — Authentication Failed
- `403` — Permission Denied
- `404` — Not Found
- `405` — Method Not Allowed
- `406` — Not Acceptable
- `429` — Throttled
- `500` — Internal Server Error

---

[API](https://skmtc.dev/azion/apis/azion-api.md) · [All operations](https://skmtc.dev/azion/apis/azion-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azion/azion-api/revisions/bb3250697218/schema)