> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# CreateDnsZone

# Package: domains

# Namespace: DomainDns

# Method link: https://dev.wix.com/docs/api-reference/account-level/domains/domain-dns/create-dns-zone.md

## Introduction

Creates a DNS zone in [Google's Cloud DNS](https://cloud.google.com/dns).


If there is an existing DNS zone for the domain, it's deleted before
the new zone is created.

The call is synchronous, that means it fails in case of an error on
Google's side.

You can only set up a single `record` object per DNS record
type. If you want to specify multiple values for the same record type, you
must save them in the `values` for the relevant type.

> __Important:__ This call requires an account level API key and cannot be authenticated with the standard authorization header.

---

## REST API

### Schema

```
 Method: createDnsZone
 Description: Creates a DNS zone in [Google's Cloud DNS](https://cloud.google.com/dns).   If there is an existing DNS zone for the domain, it's deleted before the new zone is created.  The call is synchronous, that means it fails in case of an error on Google's side.  You can only set up a single `record` object per DNS record type. If you want to specify multiple values for the same record type, you must save them in the `values` for the relevant type.  > __Important:__ This call requires an account level API key and cannot be authenticated with the standard authorization header.
 URL: https://www.wixapis.com/domains/v1/dns-zones
 Method: POST
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  dnsZone, dnsZone.domainName, dnsZone.records.type, dnsZone.records.hostName, dnsZone.records.values
 Method parameters: 
   param name: dnsZone | type: DnsZone | description: DNS zones hold information about the records that map a domain's URL to an IP address. | required: true
        - name: domainName | type: string | description: Domain name including the TLD. Both root domains and subdomains are supported. | required: true
        - name: records | type: array<DnsRecord> | description: DNS records. You can only set up a single `record` object per DNS record type. If you want to specify multiple values for the same record type, you must save them in the `values` for the relevant type.  Min: 2 DNS record - a DNS zone file has to have at least two required DNS records: NS and SOA records Max: 5000 DNS records 
           - name: type | type: RecordType | description: [DNS record type](https://en.wikipedia.org/wiki/List_of_DNS_record_types). 
                 - enum:
                 -     UNKNOWN: Default value. Used in case the record type isn't known. You can't set a record type to `UNKNOWN`.
                 -     A: Address record. Most fundamental type of DNS record that indicates the IP address of a given domain.
                 -     AAAA: Address record in [IPv6 format](https://en.wikipedia.org/wiki/IPv6).
                 -     NS: Name server record. Describes which server contains the actual DNS record.
                 -     SOA: [Start of authority record](https://en.wikipedia.org/wiki/SOA_record). Holds administrative information about the zone.
                 -     CNAME: [CNAME record](https://en.wikipedia.org/wiki/CNAME_record). Maps an alias name to the canonical domain name.
                 -     MX: MX record. Directs emails to mail servers.
                 -     TXT: [TXT record](https://en.wikipedia.org/wiki/TXT_record). Used by domain admins to add human-readable descriptions.
                 -     SPF: SPF record. Used for email authentication.
                 -     SRV: [Service record](https://en.wikipedia.org/wiki/SRV_record). Defines the server location.
                 -     PTR: Pointer record. Specifies which host is supported for a given IP address.
                 -     NAPTR: [Name Authority Pointer record](https://en.wikipedia.org/wiki/NAPTR_record). Used by Internet telephony applications.
           - name: hostName | type: string | description: Host name. Can be a subdomain. For example, `domain.com` or `mail.domain.com`. Equal to the domain name, except for `CNAME` records. 
           - name: ttl | type: integer | description: [Time to live](https://en.wikipedia.org/wiki/Time_to_live) in seconds. 
           - name: values | type: array | description: DNS record values. Wix limits DNS records to 50 values per type. External providers may support a different maximum number of DNS records for a specific type, Wix doesn't validate that you don't exceed these external limits.  Max: 50 records 
        - name: dnssecEnabled | type: boolean | description: Whether [DNS Security Extensions (DNSSEC)](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions) are enabled.  Default: `false` 
 Return type: CreateDnsZoneResponse
  - name: dnsZone | type: DnsZone | description: Created DNS zone. 
     - name: domainName | type: string | description: Domain name including the TLD. Both root domains and subdomains are supported. 
     - name: records | type: array<DnsRecord> | description: DNS records. You can only set up a single `record` object per DNS record type. If you want to specify multiple values for the same record type, you must save them in the `values` for the relevant type.  Min: 2 DNS record - a DNS zone file has to have at least two required DNS records: NS and SOA records Max: 5000 DNS records 
        - name: type | type: RecordType | description: [DNS record type](https://en.wikipedia.org/wiki/List_of_DNS_record_types). 
             - enum:
             -     UNKNOWN: Default value. Used in case the record type isn't known. You can't set a record type to `UNKNOWN`.
             -     A: Address record. Most fundamental type of DNS record that indicates the IP address of a given domain.
             -     AAAA: Address record in [IPv6 format](https://en.wikipedia.org/wiki/IPv6).
             -     NS: Name server record. Describes which server contains the actual DNS record.
             -     SOA: [Start of authority record](https://en.wikipedia.org/wiki/SOA_record). Holds administrative information about the zone.
             -     CNAME: [CNAME record](https://en.wikipedia.org/wiki/CNAME_record). Maps an alias name to the canonical domain name.
             -     MX: MX record. Directs emails to mail servers.
             -     TXT: [TXT record](https://en.wikipedia.org/wiki/TXT_record). Used by domain admins to add human-readable descriptions.
             -     SPF: SPF record. Used for email authentication.
             -     SRV: [Service record](https://en.wikipedia.org/wiki/SRV_record). Defines the server location.
             -     PTR: Pointer record. Specifies which host is supported for a given IP address.
             -     NAPTR: [Name Authority Pointer record](https://en.wikipedia.org/wiki/NAPTR_record). Used by Internet telephony applications.
        - name: hostName | type: string | description: Host name. Can be a subdomain. For example, `domain.com` or `mail.domain.com`. Equal to the domain name, except for `CNAME` records. 
        - name: ttl | type: integer | description: [Time to live](https://en.wikipedia.org/wiki/Time_to_live) in seconds. 
        - name: values | type: array | description: DNS record values. Wix limits DNS records to 50 values per type. External providers may support a different maximum number of DNS records for a specific type, Wix doesn't validate that you don't exceed these external limits.  Max: 50 records 
     - name: id | type: string | description: GUID of the Dns Zone. Identical to the domain name including TLD. 
     - name: dnssecEnabled | type: boolean | description: Whether [DNS Security Extensions (DNSSEC)](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions) are enabled.  Default: `false` 
     - name: dnssecInfo | type: DnssecInfo | description: Information about [DNSSEC](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions). Available only if `{"dnssecEnabled": true}`. 
        - name: keyTag | type: integer | description: Unique 16-bit identifier for a [DNSKEY](https://cloud.google.com/dns/docs/reference/rest/v1/dnsKeys) record that allows efficient DNSSEC validation in zones with multiple keys. 
        - name: digest | type: string | description: Cryptographic hash of the [DNSKEY](https://cloud.google.com/dns/docs/reference/rest/v1/dnsKeys) record that's included in the delegation signer (DS) record and ensures secure DNSSEC validation. 


```

### Examples

### Create a DNS zone.
```curl
curl -X POST
'https://www.wixapis.com/domains/v1/dns-zones' \
-H 'wix-account-id: <ACCOUNT_ID>' \
-H 'Authorization: <AUTH>' \
-d '{
  "dnsZone": {
    "records": [
      {
        "values": [
          "10 aspmx.l.google.com"
        ],
        "ttl": 3600,
        "hostName": "mysite.com",
        "type": "MX"
      }
    ],
    "domainName": "mysite.com"
  }
}'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.domains.DomainDns.createDnsZone(dnsZone)
 Description: Creates a DNS zone in [Google's Cloud DNS](https://cloud.google.com/dns).   If there is an existing DNS zone for the domain, it's deleted before the new zone is created.  The call is synchronous, that means it fails in case of an error on Google's side.  You can only set up a single `record` object per DNS record type. If you want to specify multiple values for the same record type, you must save them in the `values` for the relevant type.  > __Important:__ This call requires an account level API key and cannot be authenticated with the standard authorization header.
 # Note: If the parameter `a.b` is listed under required parameters, `b` is only required if `a` is also present.
 Required parameters:  dnsZone, dnsZone.domainName, dnsZone.records.type, dnsZone.records.hostName, dnsZone.records.values
 Method parameters: 
   param name: dnsZone | type: DnsZone | description: DNS zones hold information about the records that map a domain's URL to an IP address. | required: true
        - name: domainName | type: string | description: Domain name including the TLD. Both root domains and subdomains are supported. | required: true
        - name: records | type: array<DnsRecord> | description: DNS records. You can only set up a single `record` object per DNS record type. If you want to specify multiple values for the same record type, you must save them in the `values` for the relevant type.  Min: 2 DNS record - a DNS zone file has to have at least two required DNS records: NS and SOA records Max: 5000 DNS records 
           - name: type | type: RecordType | description: [DNS record type](https://en.wikipedia.org/wiki/List_of_DNS_record_types). 
                 - enum:
                 -     UNKNOWN: Default value. Used in case the record type isn't known. You can't set a record type to `UNKNOWN`.
                 -     A: Address record. Most fundamental type of DNS record that indicates the IP address of a given domain.
                 -     AAAA: Address record in [IPv6 format](https://en.wikipedia.org/wiki/IPv6).
                 -     NS: Name server record. Describes which server contains the actual DNS record.
                 -     SOA: [Start of authority record](https://en.wikipedia.org/wiki/SOA_record). Holds administrative information about the zone.
                 -     CNAME: [CNAME record](https://en.wikipedia.org/wiki/CNAME_record). Maps an alias name to the canonical domain name.
                 -     MX: MX record. Directs emails to mail servers.
                 -     TXT: [TXT record](https://en.wikipedia.org/wiki/TXT_record). Used by domain admins to add human-readable descriptions.
                 -     SPF: SPF record. Used for email authentication.
                 -     SRV: [Service record](https://en.wikipedia.org/wiki/SRV_record). Defines the server location.
                 -     PTR: Pointer record. Specifies which host is supported for a given IP address.
                 -     NAPTR: [Name Authority Pointer record](https://en.wikipedia.org/wiki/NAPTR_record). Used by Internet telephony applications.
           - name: hostName | type: string | description: Host name. Can be a subdomain. For example, `domain.com` or `mail.domain.com`. Equal to the domain name, except for `CNAME` records. 
           - name: ttl | type: integer | description: [Time to live](https://en.wikipedia.org/wiki/Time_to_live) in seconds. 
           - name: values | type: array | description: DNS record values. Wix limits DNS records to 50 values per type. External providers may support a different maximum number of DNS records for a specific type, Wix doesn't validate that you don't exceed these external limits.  Max: 50 records 
        - name: dnssecEnabled | type: boolean | description: Whether [DNS Security Extensions (DNSSEC)](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions) are enabled.  Default: `false` 
 Return type: PROMISE<DnsZone>
  - name: domainName | type: string | description: Domain name including the TLD. Both root domains and subdomains are supported. 
  - name: records | type: array<DnsRecord> | description: DNS records. You can only set up a single `record` object per DNS record type. If you want to specify multiple values for the same record type, you must save them in the `values` for the relevant type.  Min: 2 DNS record - a DNS zone file has to have at least two required DNS records: NS and SOA records Max: 5000 DNS records 
     - name: type | type: RecordType | description: [DNS record type](https://en.wikipedia.org/wiki/List_of_DNS_record_types). 
         - enum:
         -     UNKNOWN: Default value. Used in case the record type isn't known. You can't set a record type to `UNKNOWN`.
         -     A: Address record. Most fundamental type of DNS record that indicates the IP address of a given domain.
         -     AAAA: Address record in [IPv6 format](https://en.wikipedia.org/wiki/IPv6).
         -     NS: Name server record. Describes which server contains the actual DNS record.
         -     SOA: [Start of authority record](https://en.wikipedia.org/wiki/SOA_record). Holds administrative information about the zone.
         -     CNAME: [CNAME record](https://en.wikipedia.org/wiki/CNAME_record). Maps an alias name to the canonical domain name.
         -     MX: MX record. Directs emails to mail servers.
         -     TXT: [TXT record](https://en.wikipedia.org/wiki/TXT_record). Used by domain admins to add human-readable descriptions.
         -     SPF: SPF record. Used for email authentication.
         -     SRV: [Service record](https://en.wikipedia.org/wiki/SRV_record). Defines the server location.
         -     PTR: Pointer record. Specifies which host is supported for a given IP address.
         -     NAPTR: [Name Authority Pointer record](https://en.wikipedia.org/wiki/NAPTR_record). Used by Internet telephony applications.
     - name: hostName | type: string | description: Host name. Can be a subdomain. For example, `domain.com` or `mail.domain.com`. Equal to the domain name, except for `CNAME` records. 
     - name: ttl | type: integer | description: [Time to live](https://en.wikipedia.org/wiki/Time_to_live) in seconds. 
     - name: values | type: array | description: DNS record values. Wix limits DNS records to 50 values per type. External providers may support a different maximum number of DNS records for a specific type, Wix doesn't validate that you don't exceed these external limits.  Max: 50 records 
  - name: _id | type: string | description: GUID of the Dns Zone. Identical to the domain name including TLD. 
  - name: dnssecEnabled | type: boolean | description: Whether [DNS Security Extensions (DNSSEC)](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions) are enabled.  Default: `false` 
  - name: dnssecInfo | type: DnssecInfo | description: Information about [DNSSEC](https://en.wikipedia.org/wiki/Domain_Name_System_Security_Extensions). Available only if `{"dnssecEnabled": true}`. 
     - name: keyTag | type: integer | description: Unique 16-bit identifier for a [DNSKEY](https://cloud.google.com/dns/docs/reference/rest/v1/dnsKeys) record that allows efficient DNSSEC validation in zones with multiple keys. 
     - name: digest | type: string | description: Cryptographic hash of the [DNSKEY](https://cloud.google.com/dns/docs/reference/rest/v1/dnsKeys) record that's included in the delegation signer (DS) record and ensures secure DNSSEC validation. 


```

### Examples

### Create a DNS zone with an API Key
```javascript
import { createClient, ApiKeyStrategy } from "@wix/sdk";
import { domainDns } from "@wix/domains";

const wixClient = createClient({
  modules: { domainDns },
  auth: ApiKeyStrategy({
    siteId: "MY-SITE-ID",
    apiKey: "MY-API-KEY",
  }),
});

async function createDnsZone(dnsZone) {
  const response = await domainDns.createDnsZone(dnsZone);
}

```

### createDnsZone (self-hosted)
Self-hosted SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { domainDns } from '@wix/domains';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { domainDns },
  // Include the auth strategy and host as relevant
});


async function createDnsZone(dnsZone) {
  const response = await myWixClient.domainDns.createDnsZone(dnsZone);
};
```

---