Skip to content
  • There are no suggestions because the search field is empty.

Connect The Things Stack to Humly Sensor Gateway

If your LoRaWAN sensors use The Things Stack, you connect it to Humly Sensor Gateway (HSG) with a webhook. This covers The Things Network and The Things Industries.

In this article

Before you start

Make HSG reachable

The Things Stack runs in the cloud. It sends the webhook from the internet, so HSG must be reachable from outside your network.

  • Publish only the webhook path, /lora/uplink, through a reverse proxy or firewall rule.
  • Use HTTPS with a certificate from a public certificate authority.
  • Do not expose the HSG dashboard to the internet.

If sensor data must stay in your network, use an on-site network server such as ChirpStack instead. See Connect ChirpStack to Humly Sensor Gateway.

Step 1: Create a webhook token in HSG

  1. In the HSG dashboard, go to Settings.
  2. Under LNS webhook tokens, click + Create LNS token.
  3. Name it, for example the-things-stack, and click Create.
  4. Copy the Bearer token. HSG shows it only once.

Step 2: Add the webhook

  1. Open your application and go to Integrations > Webhooks.
  2. Click + Add webhook and choose Custom webhook.
  3. Enter a Webhook ID, for example humly-hsg.
  4. Set Webhook format to JSON.
  5. Set Base URL to the public HTTPS address of HSG, for example https://hsg.example.com.
  6. Under Additional headers, add Authorization with the value Bearer <token>.
  7. Under Enabled event types, tick Uplink message and set its path to /lora/uplink. Leave the other event types off.
  8. Click Add webhook.

Step 3: Check that data arrives

  1. Wait for the sensors' next uplink.
  2. In HSG, go to Sensors. The sensors appear as Pending, with the source TTN.
  3. Click Confirm on each sensor you want in Humly, and give it a name.

If nothing arrives, open the webhook in The Things Stack console. A failed webhook shows an error there. HTTP 401 means the token is wrong.

Humly Sensor Gateway guide

Get started

Install and set up

Connect sensors

Manage and troubleshoot