How to create a domain via API

Is there a documantation or a web site how to create a subdomain like

I have created an account - but if i want to create a domain, like “lkjsadiasudkjshadkjhsadkjhsad” for

I call
echo ‘{“email”: “mymail”, “password”: “mypasswd”}’ | curl -X POST --header “Content-Type: application/json” --data @-
i get a token like: “token”:“YTxxxxxxxxxxxxxxxx”}

Then I call

echo ‘{“name”: “lkjsadiasudkjshadkjhsadkjhsad”}’ | curl -X POST --header “Authorization: Token YTxxxxxxxxxxxxxxxx” --header “Content-Type: application/json” --data @-

And I get for all subdomains I try:

{“name”:[“This domain name conflicts with an existing zone, or is disallowed by policy.”]}

There seem to be a trick - but I have no idea, what to change.

Probably threre is a webinterface with more error checking and a more usefull error output?

Hi halhalhal,

Thanks for your message, and welcome to deSEC! :slight_smile:

In the name field, you need to provide the full domain name, including

Stay secure,


ok. That was unexpected for me, because I call in the url.


The token from deSEC – Free Secure DNS
wont work.
new tokenfrom web interface
curl --user “lkjsadiasudkjshadkjhsadkjhsad:$webtoken” “$myipv4&myipv6=$myipv6

Say: Invalid token.

Only the tokens from
echo ‘{“email”: “mymail”, “password”: “mypasswd”}’ | curl -X POST --header “Content-Type: application/json” --data @-
seems to do the job.

A saw a documentatio IP Update API — deSEC DNS API documentation with an example
curl “”
–header "Authorization: Token "
That wont work either.
I replaced term ?myipv4 must be replaced by &myipv4

And this now t least works. Hurray.

curl “” --header "Authorization: Token "

An update with username and password without token would be nice :slight_smile:
Now I am fighting with the token api now to get the token scripted from the JSON autput on an IoT system without any json support.