# Destinations

## What is a Destination?

Unlock the power of your IoT data with KPN Destinations. Whether you want to visualize, enrich, analyze or build complete AI products with your IoT data, our destinations offer flexible connections to any proprietary or cloud platforms of your choice.

With integrated custom apps, pre-built visualisation templates, or popular cloud environments, you're free to choose the platform that best fits your needs. Plus, you can skip the hassle of reformatting data; if desired - we've handled that for you. Start to build, scale, and optimize platforms seamlessly for IoT success, with no platform restrictions.

No KPN Things account? No worry. Get started [here](https://docs.kpnthings.com/kpn-things/getting-started/quickstart/registration-and-setup).

To create a destination you'll need;

* **Name** - A descriptive name for your Destination.
* **Description** (optional) - Some more information about your Destination.
* **Destination type** - The type of Destination you are adding. KPN Things supports several.

Created Destinations have additional information:

* **UUID** - The technical identifier of your Destination.
* **Destination status** - The operational status of your Destination.

### Destination types

Multiple different Destination types are supported by KPN Things. Each Destination type has its own configuration attributes and specific working, explained on the corresponding *More info* page. 

Missing Destinations? [Send us a message.](https://app.gitbook.com/u/GlAaApqAtkWuG28v2nSDXKsmJpa2) 

<figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FQNXXf6fm6xoVwn4Fi8Ud%2FDestinations-1.png?alt=media&#x26;token=0d3193a8-6a6f-489c-ba87-596ee352c54a" alt=""><figcaption></figcaption></figure>

| Destination type                                                                                                      | Description                                                                                                                                                                |
| --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [HTTPS endpoint](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/https-destination)                | Send data from your Devices to an HTTPS endpoint in SenML format with a method for origin verification.                                                                    |
| [MQTT broker](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/mqtt-broker)                         | Let KPN Things connect to your MQTT broker and publish data from your Device to the topics you want.                                                                       |
| [Cumulocity IoT Platform](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/cumulocity-iot-platform) | Let KPN Things manage your Devices, send measurements and location updates to your Cumulocity environment.                                                                 |
| [Azure Event Hubs](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/azure-event-hubs)               | Send data from your Devices to an Azure Event Hubs in SenML format.                                                                                                        |
| [Azure IoT Hub](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/azure-iot-hub)                     | Let KPN Things manage your Devices and send telemetry data in your Azure IoT Hub.                                                                                          |
| [ThingsBoard](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/thingsboard)                         | <p>Send data from your devices to the </p><p>ThingsBoard open source IoT platform.</p>                                                                                     |
| [Datacake](https://docs.kpnthings.com/kpn-things/building-blocks/destinations/datacake)                               | <p>Send data from your devices to the </p><p>Datacake platform.</p>                                                                                                        |
| [Amazon Web Services (AWS) ](https://aws.amazon.com/lambda/)                                                          | Send data to AWS Lambda to enable AWS's comprehensive set of infrastructure capabilities and services                                                                      |
| [Google Cloud Run functions](https://cloud.google.com/functions)                                                      | <h4 id="automate-extend-google-workspace-with-simple-code">Send data to a Google Workspace to automate & extend tasks across Google products, powered by Google Drive</h4> |

### Destination types capabilities

We currently support five types of destinations:

<table data-header-hidden><thead><tr><th width="179">Destination type</th><th width="121">Mgmt</th><th width="155">Up</th><th width="171">Down</th></tr></thead><tbody><tr><td><strong>Destination type</strong></td><td><strong>Mgmt</strong></td><td><strong>Uplink communication</strong></td><td><strong>Downlink communication</strong></td></tr><tr><td><a href="destinations/https-destination">HTTPS endpoint</a></td><td>❌</td><td>✅</td><td>❌</td></tr><tr><td><a href="destinations/mqtt-broker">MQTT broker</a></td><td>❌</td><td>✅</td><td>🔜</td></tr><tr><td><a href="destinations/cumulocity-iot-platform">Cumulocity IoT platform</a></td><td>✅</td><td>✅</td><td>✅</td></tr><tr><td><a href="destinations/azure-event-hubs">Azure Event Hubs</a></td><td>❌</td><td>✅</td><td>❌</td></tr><tr><td><a href="destinations/azure-iot-hub">Azure IoT Hub</a></td><td>✅</td><td>✅</td><td>🔜</td></tr><tr><td><a href="destinations/thingsboard">ThingsBoard</a></td><td>✅</td><td>✅</td><td>❌</td></tr><tr><td><a href="destinations/datacake">Datacake</a></td><td>❌</td><td>✅</td><td>✅</td></tr><tr><td><a href="https://aws.amazon.com/lambda/">AWS</a></td><td>🔜</td><td>✅</td><td>🔜</td></tr><tr><td><a href="https://developers.google.com/apps-script">Google</a></td><td>🔜</td><td>✅</td><td>🔜</td></tr></tbody></table>

> **Mgmt** - Whether KPN Things can manage objects in the connected Destination.\
> **Up** - Whether KPN Things can send uplink data to the connected Destination.\
> **Down** - Whether KPN things can send downlink data to the connected Destination.

### Destination status

| Status           | Description                                                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| 🟢 Active        | The Destination is operational and will forward incoming data.                                                     |
| ⚫ Deactivated    | <p>The Destination is (temporarily) deactivated and will not send <br>data to the configured endpoint.</p>         |
| ⚫ Not yet linked | <p>Your Destination is not connected to a Flow, so no data will be <br>exchanged with the configured endpoint.</p> |

## All Destinations page

The All Destinations page can be reached by clicking on **All Destinations** in the side menu of the Portal.

<figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FF8QrRtvo8ou755MKKHGj%2Fimage.png?alt=media&#x26;token=1ff7e568-ec84-4014-90b4-8de212e8a9eb" alt=""><figcaption></figcaption></figure>

On this page you will find:

1. The number of Destinations you have.
2. A table with information about all your Destinations:
   1. Their name.
   2. Their [Destination type](#destination-types).
   3. In which Projects they are used.
   4. To how many Flows they are linked.
   5. Their [Destination status](#destination-status).
3. A button to add a new Destination.

Clicking on a row in the Destinations table will link you to the [Destination detail page](#destination-details-page) for that Destination.

### Add new Destination

When adding a new Destination, you first have to select the type of Destination you want to add. Each Destination type has its own input form presenting you with all configuration options you have for the Destination.

Check out all available [Destination types](#destination-types) and click on *More info* to get more details about that Destination type. All configuration options are explained, as well as the detailed working of each Destination type.

After entering the correct values, click the *Add* button to add your Destination.

## Destination details page

This page offers you with all detailed information about your Destination.

<figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FZJ36ZORyd1VzzFH63LXC%2Fimage.png?alt=media&#x26;token=897e7978-a5a7-40d6-85cd-6b165d6f947d" alt=""><figcaption></figcaption></figure>

The elements on this page are:

1. The name of your Destination.
2. General information about your Destination.
3. Status information about your Destination:
   1. The Destination status.
   2. The Flows your Destination is linked to.
4. Button to deactivate your Destination. If your Destination is deactivated, this will be an activation button.
5. [Destination Specification tab](#destination-specification-tab) showing you detailed information about your Destination configuration.
6. [Flows tab](#flows-tab) showing you detailed information about the Flows your Destination is linked to.
7. A button to delete your Destination. This will completely remove your Destination from KPN Things!

### Destination Specification tab

The Destination Specification tab shows you detailed information about your Destination (#1 in the screenshot below). Displayed information differs for different Destination types. The tab also offers you an **Edit** link to edit the configuration of your Destination (#2 in the screenshot below).

{% hint style="info" %}
Secret values like passwords and access keys are never displayed in the Things Portal and are even not retrievable from our systems. This ensures complete security of these values.
{% endhint %}

<figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FKQn5XG9GLDW0AyzRBYDE%2Fimage.png?alt=media&#x26;token=9b19492a-1110-4a41-a5c5-387eb2d989fb" alt=""><figcaption></figcaption></figure>

### Flows tab

The Flows tab offers you a list of all the Flows your Destination is linked to and the Project this Flow is in. You can click on a Flow to open it, or you can click on **Unlink from this Flow** to remove the Destination from that Flow. The option to link your Destination to another Flow from here will be added in the near future.

<figure><img src="https://1453626848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6RrePMSAjRvOgcHjMBZ%2Fuploads%2FuwiyXIZ32bKNWw2ACEjq%2Fimage.png?alt=media&#x26;token=9a9de414-0acd-47f2-99bd-9b5d169f97c0" alt=""><figcaption></figcaption></figure>

## Technical specifications

Do you want to whitelist our IP address in your application? This is our outgoing IP address:

{% code title="KPN Things Outgoing IP address" %}

```
194.122.128.33
```

{% endcode %}