cURL is a tool to transfer data from or to a server, using one of the many supported protocols (HTTP, HTTPS, FTP, FTPS etc). You can use cURL's HTTP and HTTPS protocol to update your free dynamic DNS hostname with Dynu.

You can do the updates in one of the two formats below:

curl "https://api.dynu.com/nic/update?username=myname&password=somepass&hostname=example.com&myip=1.2.3.4&myipv6=2602:1234::3"
curl "https://username:password@api.dynu.com/nic/update?hostname=example.com&myip=1.2.3.4&myipv6=2602:1234::3"

OR

curl -u username:password "https://api.dynu.com/nic/update?hostname=example.com&myip=1.2.3.4&myipv6=2602:1234::3"

  • cURL supports basic authentication embedded in URL so can either embed the authentication in the URL or pass in the password (or MD5 /SHA256 hash of the password) as a query string parameter.
  • URL should be enclosed in double quotes otherwise the parameters will not be sent fully by cURL.

  • If you do not want your ipv4 to update, you may pass in the parameter myip=no. Similarly, if you do not want your ipv6 to be updated, you may pass in the parameter myipv6=no. If the myip and myipv6 parameters are not passed in, the server will try to auto-detect the IP address sent by your device.

    Here are some common update URLs:

    Update one domain name

  • Non SSL: http://api.dynu.com/nic/update?hostname=example.dynu.com&password=PASSWORD
  • SSL Format: https://api.dynu.com/nic/update?hostname=example.dynu.com&password=PASSWORD

  • Update all domains in your account

  • Non SSL: http://api.dynu.com/nic/update?username=USERNAME&password=PASSWORD
  • SSL Format: https://api.dynu.com/nic/update?username=USERNAME&password=PASSWORD

  • Update a subdomain

  • Non SSL: http://api.dynu.com/nic/update?hostname=example.dynu.com&alias=Alias&username=USERNAME&password=PASSWORD
  • SSL Format: https://api.dynu.com/nic/update?hostname=example.dynu.com&alias=Alias&username=USERNAME&password=PASSWORD
  • For more information on free dynamic DNS update URLs and methodology, you may refer to the IP Update Protocol page.