Stand with Ukraine flag
Try it now Pricing
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Documentation > Integrations > KPN Things
Getting Started
Devices Library Guides API FAQ
On this page

KPN Things Integration

Doc info icon
ThingsBoard PE Feature

Only Professional Edition supports Platform Integrations feature.
Use ThingsBoard Cloud or install your own platform instance.


KPN Things is an IoT (Internet of Things) platform provided by KPN, a telecommunications company.
This platform allows users to connect and manage their IoT devices, facilitating communication and data exchange between these devices and the cloud.
After integrating KPN Things with the ThingsBoard, you can connect, manage, communicate, process and visualize data from your devices in the ThingsBoard IoT platform.

Create integration

Follow the steps below to add the KPN Things integration:

  • Go to "Integrations center" section -> "Integrations" page and click "plus" button to create new integration. Select type "KPN Things". Click "Next";
  • At this step, choose "Create new" uplink converter. The new converter will contain necessary code to convert incoming data and click "Next";
  • At the step of adding a downlink converter, you can also select a previously created or create a new downlink converter. But for now, leave the "Downlink data converter" field empty. Click "Skip";
  • Specify your base URL. Please note down "HTTP endpoint URL" we will use this value later. Then, click the "Add" button. KPN Things integration is created.

We have pre-configured integration on ThingsBoard, but we need to configure KPN Things to send data to ThingsBoard.

Configure KPN Things

To configure KPN Things, you need to open KPN Things Portal and log in to your account.

The KPN Things Portal interface may change in the future.

Add new device:

  • Go to the “Things manager” tab, and click on the “Add new device”;
  • Choose the “Device Simulator”, set a name for your device, and click on the “Add device” button;
  • Install and open the “KPN Things Device simulator” app on your phone. Follow the instructions on your phone to scan this QR code. Then, click on the “Add Network Info” button;
  • KPN Internet Network is created. Now, click on the “Finish” button;

Link the device to the “Flow”:

  • Go to the “Flows” in left menu and click on the “My first flow” row;
  • Click on the “Link Device” button in the “Devices” row;
  • Click on the “Link” button next to the device you created earlier;
  • The device has been successfully linked to the “Flow”. Now, click on the “My Device” row;

Data processing setup for my flow:

  • A “Device & Connectivity detail” page will open. Now, go to the “Flows” tab, and click on “My first flow” row;
  • Click on the “Data Processing” row to open “Data Processing details” page;
  • Change the switch to enabled state for “Decoders” section;

Add new Destination:

  • Go to “Destinations” in left menu and click on the “Add new Destination” button;
  • Find the “ThingsBoard” destination type, and click on “Choose ThingsBoard” button;
  • Set a name for your destination.
  • Paste “HTTP endpoint URL” from ThingsBoard integration page to “HTTP endpoint URL” field.
  • Now, click on the “Generate” button, and save generated value. We will use it on ThingsBoard.
  • Click on the “Add ThingsBoard Destination” button;

Link the “Destination” to the “Flow”:

  • Go to the “Flows” -> “My first flow” and click on the “Link Destination” button in the “Destinations” row;
  • Click on the “Link” button next to the destination you created earlier;
  • The “Destination” has been successfully linked to the Flow.

Update integration

In order to validate the sender we can add a token to integration on ThingsBoard. To do this, please follow the steps below:

  • Go to "Integrations center" section -> "Integrations" page and click on the integration you created earlier. Click on "Edit" button to enter edit mode.
  • Switch "Enable security (Headers filter)" toggle to enabled state and click "Add" button in "Headers filter" section.
  • Put "X-Things-Secret" to "Header" field and generated token to "Value" field. Finally, apply changes.

That’s all that is needed to configured integration between KPN Things and ThingsBoard. Now we can send data from KPN Things to ThingsBoard.

Now let’s use the “KPN Things Device simulator” app to send a message with the data to the ThingsBoard. Click the “Send data now” button in the app.

After you sent message a new device was created in your ThingsBoard instance.

Go to the ThingsBoard instance, then navigate to the “Devices” page. Here you will find a new KPN Device and information about it as well as the telemetry that we sent to the device.

Go to the “Integrations” page, select “KPN Things integration” and navigate to the “Events” tab. There you’ll see the message consumed by the KPN Things integration.

Next steps