Domain & DNS API

Dynamic DNS from your own command line!

Dynamic DNS (DDNS) interface

We provide a DDNS interface so you can use your domain with routers and other dynamic hosts. This type of protocol is pretty ancient and comes with a few restrictions in general and on our end, including overwriting CAA records so do not use the API if you have any CAA records in place.

Because this API requires you to use login credentials (via BasicAuth) we highly recommend you to use a separate account for any of your dynamic DNS needs and CNAME from your main production domain to this setup.

Here is how it works:

To add A or AAAA records:


    curl -u "[USERNAME]:[PASSWORD]" "https://iwantmyname.com/basicauth/ddns?hostname=[HOSTNAME]&myip=[IP]"

The username/password parameters are your normal iwantmyname login credentials, the hostname is the full host you want to update like home.mydomain.io and the myip parameter is the optional IP address you want to update the A record with. If this parameter is not set we update it to the IP the request is coming from. You can also include an optional TTL value for the record: '&ttl=[VALUE]' if not specified the default value is 3600 (1 hour)

*Note: Older routers may only support GET requests, however the cleaner way of doing it is using POST or PUT requests

You can also add other record types such as TXT, MX, CNAME, NAPTR & SRV.

curl -u "[USERNAME]:[PASSWORD]" "https://iwantmyname.com/basicauth/ddns?hostname=[HOSTNAME]&type=[RECORD_TYPE]&value=[RECORD_VALUE]"

To ADD a TXT record:


      curl -u "user@user_email.com:P@$$W0>d" "https://iwantmyname.com/basicauth/ddns?hostname=verify.mydomain.com&type=txt&value=Xh90WmC95K1GAlAcEF0psz3c2GOandqdqMInclDxd"

To DELETE a TXT record:


      curl -u "user@user_email.com:P@$$W0>d" "https://iwantmyname.com/basicauth/ddns?hostname=verify.mydomain.com&type=txt&value=delete"

"value=delete" deletes the record defined in "type" and "hostname"

*Note: With TXT records, new records will not overwrite existing ones, so you should delete the ones no longer wanted.

Some more info about the service is on our blog.