Dynamic DNS Services

Our dynamic dns services work based on simple HTTP/HTTPS GET requests using dyndns2 protocol.

Clients

Several clients are available:

Protocol reference

You can request a host update using the next HTTP GET request:

curl 'http://youremail%40address.com:yourpassword@www.visualdns.net/nic/update?hostname=www.mydomain.com&myip=1.2.3.4'
good

In this case youremail@address.com is used as username, but also your username can be used.

curl 'http://username:yourpassword@www.visualdns.net/nic/update?hostname=www.mydomain.com&myip=1.2.3.4'
good

Supported parameters

The parameters can be a certain value, but also YES, NO and nochg to avoid changing that parameter.

hostname is the A entry to be updated, it must be in your domain record listing.
myip is the IPv4 address that will be updated into your A record

Optional parameters

mx must be a host name, where the mx record for your domain (highest priority) will be sent to, you can keep aditional MX records with lower priorities, that will be untouched
backmx must be a host name, where the mx record for your domain (second highest priority) will be sent to, you can keep aditional MX records with lower priorities, that will be untouched

Responses

HTTP result code will always be 200 / OK, and the following text results could be return

good : The change is been done effectively
nochg: Everything ok, but nothing changed compared to our records.
nohost : The domain you're trying to update does not exist or does belong to a different account
numhost : There is no A record for the subdomain you're trying to update
badauth : Authentication parameters are wrong
notfqdn : malformed hostname.
badip : malformed IPv4 address.
badparam : bad parameter, can have the parameter after badparam.

Terms of service, abuse

IP updates must be only done when a real IP or MX change is done, sending the current IP repeatedly is
not an acceptable method for IP updates, and it shall result in your account getting blocked for that reason.