# Notehub

### Overview

The Qubitro and Notehub—Blues cloud service integration allows you to sync all devices and their data from Notehub to Qubitro using [Notehub Routes](https://dev.blues.io/guides-and-tutorials/routing-data-to-cloud/general-http-https/)—without writing any code.

Once your hardware is configured and sending data to Notehub, a corresponding device is automatically created in Qubitro, representing each device with its unique Notecard ID.

Qubitro decodes incoming data automatically, and transformation functions can be applied if modifications are needed before storage.

{% hint style="info" %}
This integration **does not** **require** manual MQTT or HTTP forwarding from your device. Data flows directly between Notehub and Qubitro with no additional setup required on the device side.
{% endhint %}

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

* [x] Administrative access to both accounts
* [x] A Qubitro account with an existing project
* [x] A Notehub account with a project containing devices

### How It Works

Below is the diagram that shows how the integration works.

{% @mermaid/diagram content="graph LR;
A\[Device Publishes Data to Notehub] --> B{Device Exists in Qubitro?};

B -- No --> C\[Qubitro Creates Device with Notecard ID];
B -- Yes --> D\[Use Existing Device];

C --> E\[Apply Built-in Decoder];
D --> E;

E --> F\[Store Data in Qubitro];

%% Style Adjustments
style A fill:#d9d9d9,stroke:#000,color:#000;
style B fill:#f2f2f2,stroke:#000,color:#000;
style E fill:#e0e0e0,stroke:#000,color:#000;" %}

{% hint style="warning" %}
If a [Transformation Function](https://qubitro.gitbook.io/qubitro-documentation/platform/functions/options/transformation-function) is enabled, data will be processed before storage. The built-in decoder applies first, and then any defined transformation function modifies the data before it is stored in Qubitro.
{% endhint %}

### Configuring the Integration

{% stepper %}
{% step %}

#### Step 1: Create an Integration in Qubitro

1. Log in to the **Qubitro Portal**.
2. Select a project from the list.
3. Click **New Source**.
4. Select **Notehub** from the available sources.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2F4cDWnL5wYpkIFmLcytj7%2FCleanShot%202025-03-01%20at%2017.49.20%402x.png?alt=media&#x26;token=b368f6a5-a5ab-40be-bda0-01a2bac61a1a" alt="" width="563"><figcaption></figcaption></figure>

This page will display the **Host URL** and **required headers** for Notehub configuration. Keep it open for the next step.
{% endstep %}

{% step %}

#### Step 2: Set Up a Route in Notehub

1. Log in to **Notehub**.
2. Open your **Notehub project**.
3. Click **+ Create Route**.
4. Select **General HTTP/HTTPS Request/Response** as the route type.
5. Paste the **Host URL** copied from Qubitro into the **Route URL** field.
6. Add the **headers** from Qubitro to the corresponding fields.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FuqrBig6Nvv1wbB8NANZx%2FCleanShot%202025-03-01%20at%2017.51.18%402x.png?alt=media&#x26;token=dfd6d381-b681-4edd-b2c9-406df2ae203e" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Step 3: Configure Data Routing

1. **Choose Fleet (optional)** – If you have multiple fleets, select the appropriate one.
2. **Choose Notefile** – Select the Notefile you want to forward.
3. **Choose Body Only** in the **Data** section.
4. Click **Save** to create the route.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2F10uClQcJ7LTayALprtYY%2FCleanShot%202025-03-01%20at%2017.57.09%402x.png?alt=media&#x26;token=ebdf9f68-e29b-4cfe-ba10-b72644b5ea40" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Step 4: Verify the Integration

1. Return to **Qubitro Portal**.
2. Click **Go to Project** and then **Refresh** to check if the devices appear.
3. Open a device and navigate to the **Data** tab to verify incoming data.
   {% endstep %}
   {% endstepper %}

### Frequently Asked Questions

<details>

<summary>Do I need to set up MQTT or HTTP forwarding in Notehub?</summary>

No. The integration works directly between Notehub and Qubitro using **Notehub Routes**. No additional forwarding setup is needed.

</details>

<details>

<summary>Do I need to send data from my device to Qubitro?</summary>

No. Once data is sent to Notehub, it is automatically forwarded to Qubitro via the **Notehub Route**.

</details>

<details>

<summary>Can I group Notecards under different Qubitro projects?</summary>

Yes. You can create multiple integrations to separate Notecards across different projects.

</details>

<details>

<summary>Are there additional fees for this integration?</summary>

No. There are no hidden costs such as data transfer (egress) fees for using the Qubitro <> Blues Notehub integration.

</details>