How to add Messenger notifications to TokenDNS?

What is Messenger?

Messenger is probably one of the most used messenger in the world and everyone who has a Facebook account is using it. After we introduced Facebook as authentication method, its now possible to get notifications when your records changed. No need for any additional app on your phone.

What do I need to use Messenger with TokenDNS?

Its very easy. When you are logged in TokenDNS, just open the Messenger site and click Send to Messenger. Thats it!

Visit now.


I want to use the API!

Unfortunately this is not possible ūüôĀ


How to add PagerDuty notification to TokenDNS?


What is PagerDuty?

PagerDuty is present in most companies who have on call duty. Most are using it in combination with several monitoring systems. Its easy to handle schedules and organise responsibilities.

What do I need to use PagerDuty with TokenDNS?

For obvious reason you need to have an account for PagerDuty. In PagerDuty you can create so called Services and for each service you can create a Integrations. Each integration has a service key and this is what we need.

Now login to PagerDuty and select the Service that should receive notifications from us:
Configuration -> Services -> Select or Create a Service
If you already have a service, go to Integrations and add a new integration:


Please select “Use our API directly” and set a proper name. After hitting the green button you will redirect to the previous page and you can see your Integration Key. This key is our token.
We have everything what we need and can enable notification in TokenDNS. Go to your settings and add PagerDuty to your notifications.


I want to use the API!

I hear you and like it. Easy as you know it:

curl --get "" \
  -d apikey=${apikey} \
  -d action=add
  -d provider=pagerduty
  -d description=${service_description}
  -d token=${token_id}

Notifications are here to keep you informed!


It’s now even easier to keep up to date with your DNS records. The notification integration allows you to get informed instantly when a record changes.
This can be very helpful to detect misconfigurations or updates in your DynDNS.

At the moment we support Slack, Pushover, Email and Webhooks. The configuration can be done in your Settings or use our easy API.

Full documentation and API examples can be found in the following post:


More integrations will come in the future to make it even more useful for you. Which integration are you looking for the most?

How to add Pushover notification to TokenDNS?


What is Pushover?

Pushover is an app that allows you to send custom messages in realtime to your iOS, Android and other devices. It’s very reliable and easy to use.

What do I need to use Pushover with TokenDNS?

You need to register with and have at least one app installed on your device. To use BlaBlaDNS with pushover you need to create an Application and obtain User ID and API Token.

When you are logged in pushover you need to create a new application. Go to Applications and click Register an Application.


Afterwards you need to add the details of the application. Give it a name, description and type (e.g. Website) and add a good looking logo. You can grab the TokenDNS Logo here. At the end hit Create Application.


When the application is created you can get the API Token from the application details. Just click on the Application name and obtain the token.


Yes, its the one behind that good looking black banner. Whats next? We need the User ID. This you have probably seen. Its on the main page at the top right corner.

How to enable Pushover Notifications?

When you have your API Token and User ID we can enable Pushover notification in TokenDNS. When you are logged in, go to Settings and select Pushover in the dropdown menu.


You will be prompted to add your credentials. Hit Add Notification and the next time you reserve or change a record you will receive a notification.


I want to use the API!

I hear you and like it. Easy as you know it:

curl --get "" \
  -d apikey=${apikey} \
  -d action=add
  -d provider=pushover
  -d user=${user_id}
  -d token=${token_id}

How to add Slack notification to TokenDNS?


What is Slack?

Slack is a team communication platform. Nowadays it’s used widely in many companies and makes it very easy to communicate and share files with your colleagues. If you don’t know it, its worth to take a look.

What do I need to use Slack with TokenDNS?

For obvious reason you need to have an account with Slack. Log into TokenDNS, go to Settings and select Slack from the pulldown menu.


You will get redirected to Slack where you can select the channel where the messages will get delivered. Nothing easier than adding Slack as a notification. Want to see one?


I want to use the API!

I hear you, but unfortunately its not possible to add Slack notification with the api. Why? Not our fault!

How to add Email notification to TokenDNS?


How to enable Email Notifications?

One of the easiest and oldest communication channels in the digital age that still exist. What you need? An Email address.
Go to Settings and select Email in the pulldown menu.


You will be prompted to add your credentials. Hit Add Notification and the next time you reserve or change a record you will receive a notification.

I want to use the API!

I hear you and like it. Easy as you know it:

curl --get "" \
  -d apikey=${apikey} \
  -d action=add
  -d provider=email
  -d recipient=${email_address}

How to add a Webhook notification to TokenDNS?


What is a Webhook?

A Webhook is a HTTP POST call that will send a message to your server or application. This is mainly used for deeper integrations. Lets say you have a DNS caching service running and need to flush the record that just got changed to have immediately access.
But basically everything is possible with a Webhook and thats why it was important to us that its available from the beginning.

What do I need to use a Webhook with TokenDNS?

First you need to have a HTTP/HTTPS endpoint where we can send the POST message to. Most of the time this is a webserver which should offer SSL.

How does the payload look like?

  "domain": "",
  "content": "",
  "message": "Record reserved for A with"

Example Webhook in PHP:

$tokendns = json_decode(file_get_contents('php://input'));
$domain = $tokendns->{domain};
$content = $tokendns->{content};
$message = $tokendns->{message};
// do something....

This is a very small example and should never go into production like this, but it will makes it very easy for you to integrate the webhook in your services.

How to enable a Webhook Notifications?

When you have your Webhook and script ready. Just head over to the BlaBlaDNS settings and select Webhook from the pulldown menu. Add your endpoint and be ready for some incoming data.


I want to use the API!

I hear you and like it. Easy as you know it:

curl --get "" \
  -d apikey=${apikey} \
  -d action=add
  -d provider=webhook
  -d webhook=${webhook_url}

API Update & Beautification


We have a small, but very crucial update for the api and some beautifications were made for the frontend too.

Whenever you reserve a new record, its possible to set the type and content of the record right away. This helps a lot and reduces the api calls that you need to make.
For example you want to integrate a DNS Update when you start a new virtual machine. Thats now possible with just one call:

curl --get "" \
  -d apikey=${apikey} \
  -d name=www5
  -d type=A
  -d content=

This will automatically create with the A record set to

Some internet provider only have IPv6 or only IPv4 running and it was always a little mess to handle both A and AAA records.
From now on you can delete the type of record that you don’t like anymore. Running only on IPv4? Then delete your AAAA record:

  curl --get "" \
  -d apikey=${apikey} \
  -d name=${name}
  -d type=AAAA

Automation should be as easy, but multifunctional ūüôā

Social Logins are here!


We are happy to announce a new feature for the BlaBlaDNS frontend. Its possible now to login with your GitHub, Twitter, Facebook and Google accounts.

Even if you should have a different password for each service that you are using, most people don’t. Thats why its very risky to register for a service where you don’t know if you password is safe.
Just to be sure, its safe with us. Your password never reaches us in cleartext. It gets encrypted in your browser, the hash gets transferred using SSL and we only store a salted version of this hash. So there is no way to crack this.

Social Login

Don’t have an account yet? Get started and use GitHub, Twitter, Facebook or Google now.


Major FRONTEND and API update

Update Record

Welcome back and lets get started.

The API got some new endpoints for your settings. Its now possible to change your username, email and reset your apikey.

How to change my username?

curl --get "" \
  -d apikey=${apikey} \
  -d action=username \
  -d value=MyNewUsername

How to change my email?

curl --get "" \
  -d apikey=${apikey} \
  -d action=email \

How to reset my apikey?

curl --get "" \
  -d apikey=${apikey} \
  -d action=apikey

All of this is possible through the frontend as well.

AND You can now reserve a subdomain through the frontend.
Just click on the “Reserve Record” button in the domain section and reserve¬†your beloved subdomain with one click.

That means that all api functions are available through the frontend and every one can use this very easily. Very exciting and ready to implement new features!