Skip to content

Create a DNS Zone

Set up DNS hosting for your domain with DNSSEC support, add records, and point your registrar to WAYSCloud nameservers.

What you are building

A DNS zone that hosts all records for your domain — A, AAAA, CNAME, MX, TXT, and more. Once your registrar delegates to WAYSCloud nameservers, all queries resolve through our anycast infrastructure.

When to use this approach

  • You need DNS hosting for a domain
  • You want API-driven DNS management
  • You need DNSSEC support

What you need

  • A WAYSCloud account
  • A registered domain name
  • Access to your domain registrar (to update nameservers)
  • An API key with DNS permissions (for the API path)

Step 1 — Create the zone

Dashboard

  1. Open ServicesNetworkingDNS Management in the dashboard
  2. Click Create Zone
  3. Enter your domain name (e.g., example.com)
  4. Click Create

The zone is created with default SOA and NS records.

API

bash
curl -X POST https://api.wayscloud.services/v1/dns/zones \
  -H "X-API-Key: $WAYSCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "zone_name": "example.com",
    "type": "PRIMARY"
  }'

Response:

json
{
  "zone_id": "zone_12345",
  "zone_name": "example.com",
  "zone_type": "PRIMARY",
  "status": "active",
  "nameservers": [
    "grieg.wayscloud.no",
    "sibelius.wayscloud.no",
    "dvorak.wayscloud.no",
    "bach.wayscloud.no"
  ]
}

Step 2 — Add DNS records

Dashboard

  1. Open your zone in the DNS dashboard
  2. Click Add Record
  3. Select the record type and fill in the values

API

Add an A record (point domain to IP):

bash
curl -X POST https://api.wayscloud.services/v1/dns/zones/example.com/records \
  -H "X-API-Key: $WAYSCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "www",
    "type": "A",
    "content": "203.0.113.42",
    "ttl": 3600
  }'

Add an MX record (email routing):

bash
curl -X POST https://api.wayscloud.services/v1/dns/zones/example.com/records \
  -H "X-API-Key: $WAYSCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "",
    "type": "MX",
    "content": "mail.example.com",
    "ttl": 3600,
    "priority": 10
  }'

Supported record types: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, PTR.


Step 3 — Update nameservers at your registrar

Log in to your domain registrar and set the nameservers to:

  1. grieg.wayscloud.no
  2. sibelius.wayscloud.no
  3. dvorak.wayscloud.no
  4. bach.wayscloud.no

DNS propagation typically takes 1–48 hours, depending on the registrar and TTL settings.


Step 4 — Verify propagation

Check that your domain resolves correctly:

bash
dig example.com @grieg.wayscloud.no

Or check the zone status in the dashboard — it shows nameserver delegation status and record counts.

API reference

WAYSCloud AS