# How to integrate TagoIO with Kinéis

**URL:** <https://community.tago.io/t/how-to-integrate-tagoio-with-kineis/1491>\
**Category:** Tutorials\
**Tags:** tutorials\
**Created:** [October 30, 2023, 5:35pm UTC](https://community.tago.io/t/how-to-integrate-tagoio-with-kineis/1491 "2023-10-30T17:35:21Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![freddy.minuzzi](https://yyz2.discourse-cdn.com/flex034/user_avatar/community.tago.io/freddy.minuzzi/32/415_2.png) [@freddy.minuzzi](https://community.tago.io/u/freddy.minuzzi)\
**Post date:** [October 30, 2023, 5:35pm UTC](https://community.tago.io/t/how-to-integrate-tagoio-with-kineis/1491/1 "2023-10-30T17:35:21Z")

</div>

This tutorial provides a step-by-step guide to integrate Kinéis with the TagoIO Platform. By following these instructions, you will enable uplink and downlink operations, allowing data exchange between your LoRaWAN devices and the TagoIO application.

## Prerequisites

Before you begin, ensure you have the following:

- Kinéis Account: If you don’t have one, [register here](https://www.kineis.com/).
- LoRaWAN Device: Ensure your device is connect to Kinéis and transmitting data.

* * *

## Step 1: Create Authorization in TagoIO

1. Access Authorizations:

2. Create a New Authorization:

3. Copy the Authorization Token:

 ![](https://canada1.discourse-cdn.com/flex034/uploads/tagoio1/original/2X/b/b1852415211a60ac607018f64bf235c12edb1cad.jpeg)

> 📝 Note: You only need to create a single Authorization code to connect Kinéis to TagoIO for **all your devices**.

* * *

## Step 2: Set Up Integration in Kinéis

Go to your [Kinéis Portal](https://services.kineis.com/home) and [create a new distribution](https://services.kineis.com/distributions/create). You can create a new distribution under the sidebar **Distribution Sidebar Icon \> Configuration \> Plus sign**.

**2.1 Configure the Distribution**

1. Add a Distribution Code.

2. Add a Distribution Name.

3. Fill in the “Active” Checkbox.

4. Click “NEXT”.

**2.2 Select Your Devices**

1. Click the Plus button to add a new devices group.

2. Add a Device Group Code.

3. Add a Device Group Name.

4. Select the devices to send data to TagoIO.

- Select them by checking their box and clicking the “\>” button to change their position to the right panel.

1. Click “CREATE”.
2. Click “NEXT”.

> 📝 Note : The “Device ID” seen here is the Device ID you will utilize when adding the Device at TagoIO.

**2.3. Select Your Data Types and Formats**

1. Click the Plus button to add a new distribution format.

2. Add a distribution data code.

3. Select the “Processed type Basic” reference format.

4. Click “CREATE”.

5. Click “NEXT”.

**2.4. Select Your Distribution Endpoint.**

Press the Plus button to add a new distribution endpoint group.

Configure the distribution:

| 
Field
 | 
Description
 |
| **Code** | Enter a unique identifier (e.g.,&nbsp;tagoio-integration). |
| 
Protocol
 | 
HTTP
 |
| **URL** | Use the endpoint format&nbsp;https://kineis.middleware.REGION.tago.io/uplink.  
Replace&nbsp; **REGION** &nbsp;with your deployment region (e.g., us-e1, eu-w1).
For a list of available regions, visit&nbsp;[TagoIO Network Integration](https://help.tago.io/portal/en/kb/articles/125-network-integration).  

 |
| 
Authentication
 | 
None
 |
| **Headers\*-Key** | Enter the word&nbsp;Authorization |
| **Headers\*-Value** | Set its value to the TagoIO Authorization token you copied in Step 2. |

 ![](https://canada1.discourse-cdn.com/flex034/uploads/tagoio1/original/2X/b/bb47503ffa5318d165ee74897b502c4c6a61b2fa.png)

> ℹ The endpoint [https://kineis.middleware.tago.io/uplink](https://kineis.middleware.tago.io/uplink) points to the USA region. As we are committed to continuing support for this endpoint, we recommend that users in the USA region update their webhooks to **[https://kineis.middleware.us-e1.tago.io/uplink](https://kineis.middleware.us-e1.tago.io/uplink)**.

**2.5.**  **Confirmation**

1. Verify the information you’ve entered is correct.
2. Press “SAVE”.

* * *

## Step 3: Add Device in TagoIO

To integrate your device with the TagoIO Platform, follow these guidelines:

1. **Ensure Device EUI Consistency:**

2. **Select the Appropriate Network and Device Type:**

3. **Add Device Support via Connectors (If Necessary):**

For detailed instructions on adding devices, visit the [Adding Devices](https://help.tago.io/portal/en/kb/articles/3-devices#Adding_devices) page.

 ![](https://canada1.discourse-cdn.com/flex034/uploads/tagoio1/original/2X/b/b16672dc522776c1575d400133026ca016529400.png)

## 

* * *

## Finalizing Setup

1. **Power On Your Devices:**

2. **Verify Data Reception:**

With data successfully flowing into TagoIO, you can start creating [dashboards](https://help.tago.io/portal/en/kb/articles/15-dashboard-overview), add [notifications](https://help.tago.io/portal/en/kb/articles/11-notification), and [create scripts](https://help.tago.io/portal/en/kb/articles/29-analysis-overview) to process your data.

Learn how to perform [downlink for LoRaWAN](https://help.tago.io/portal/en/kb/articles/220-downlink-for-lorawan).