Appearance

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 Services → Networking → DNS 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",
    "lindgren.wayscloud.se",
    "aalto.wayscloud.fi",
    "bohr.wayscloud.dk"
  ]
}

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. lindgren.wayscloud.se
  3. aalto.wayscloud.fi
  4. bohr.wayscloud.dk

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 ​