Quick Start
Contents
Five steps from zero to a working DNS record: create an account, add your domain, create an API key, create a record, and verify it resolves.
1. Create your account
Go to primedns.net/register and sign up. Check your inbox for the activation email and confirm your address before continuing.
2. Add your domain
In the panel, go to Domains → Add external domain and enter the domain you already own. This adds the zone to PrimeDNS — it does not transfer registration.

Then update your domain's nameservers at your registrar to:
ns1.primedns.net
ns2.primedns.net
3. Create an API key
Go to Account → API Keys.
In Create new API key, the dns:write scope is checked
by default — click + Create key. Copy the key now; it is
shown only once.

Limit what a key can do
Give each script or integration its own key and narrow it. Under Restrictions in the same form you can
list the IP addresses the key may be used from (one address or CIDR range per line) and tick the
zones it may touch. You can also set an expiry date and a daily spend limit.
A request from another address is answered with 403 IP_NOT_ALLOWED, and the message names the address the API saw.
Use the address your server connects from, not your browser's.
Later, use Edit on a key to change its name, expiry, spend limit, addresses or zones without replacing it. Narrowing a key needs nothing more; widening it (more addresses or zones, a later or no expiry, a higher or no spend limit) asks for your 2FA code if you use 2FA. The key itself and its scopes cannot be changed: create a new key for different scopes. Every change is recorded in the audit log.
4. Create your first DNS record
Use the key as the X-API-Key header against the PrimeDNS API:
curl -X POST https://api.primedns.net/v1/dns/records \
-H "X-API-Key: pdns_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"domain_name": "example.com",
"name": "www",
"type": "A",
"content": "203.0.113.10",
"ttl": 900
}'
name is the label only ("www"), not the full hostname —
PrimeDNS appends the zone automatically. Use "@" for the zone apex.
5. Verify it resolves
Query PrimeDNS's nameservers directly, so you don't have to wait for propagation:
dig @ns1.primedns.net www.example.com A +short
Or confirm the record exists via the API:
curl https://api.primedns.net/v1/dns/records?domain=example.com \
-H "X-API-Key: pdns_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Next steps
- ACME DNS-01 certificates: automate Let's Encrypt certificates, including wildcards, with acme.sh, certbot or cert-manager.
- Developers overview — DynDNS, webhooks, and zone import/export.