Developers

PrimeDNS is built API-first: automate zone management, record updates and monitoring directly from your tools and pipelines.

REST API

A full REST API with JSON responses. Authenticate with an API key, manage zones and records programmatically, and integrate DNS into your CI/CD pipeline.

# Update a DNS record
curl -X PATCH https://api.primedns.net/v1/dns/records/42 \
  -H "X-API-Key: pdns_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"content": "203.0.113.10"}'

API reference

Dynamic DNS

Update DNS records automatically when your IP address changes. Compatible with the DynDNS2 protocol, so it works with routers, clients and custom scripts out of the box.

# DynDNS2 compatible update
# (username of your account, not the e-mail address)
curl -4 -u "username:password" \
  "https://update.primedns.net/nic/update?hostname=myhost.example.com&myip=203.0.113.10"

Dynamic DNS guide: marking a record as dynamic, IPv4 and IPv6, answers, router settings and a message when the address changes.

Webhooks

Get notified when DNS records change, when a dynamic address is updated or when alert rules fire. Send the events to Slack, Discord, Microsoft Teams, Telegram or your own systems. Deliveries are signed, so your server can check where they come from.

POST https://your-endpoint.example.com/webhook
Content-Type: application/json

{
  "id": "3f6c1e0a-7d8b-4b7e-9c1a-2f3e4d5c6b7a",
  "version": 1,
  "event": "record.updated",
  "account_id": 139111,
  "timestamp": "2026-10-22T10:15:30Z",
  "data": {
    "record": {
      "type": "A",
      "name": "www.example.com",
      "content": "203.0.113.10"
    }
  }
}

Webhooks & Alerts shows how to set up endpoints, and Webhook events lists every event with its data and how to verify the signature.

Zone import and export

Move to PrimeDNS in minutes: import existing zones in standard BIND format, or export them at any time. No lock-in.

# Export a zone as a BIND zone file
curl https://api.primedns.net/v1/zones/example.com/export \
  -H "X-API-Key: pdns_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

$ORIGIN example.com.
$TTL 3600
@    IN  SOA  ns1.primedns.net. hostmaster.primedns.net. (
          2026032101 3600 900 604800 300 )
@    IN  NS   ns1.primedns.net.
@    IN  A    203.0.113.10
www  IN  A    203.0.113.10

Ready to start building?

Create an account and explore the API, or follow a step-by-step guide.

Create an account Read the guides API reference