---
title: How to set up and use a Sigfox network
description: This page explains how to set up and use a Sigfox network
tags: iot iot-hub sigfox sigfox-network
dates:
  validation: 2025-07-16
  validation_frequency: 12
  posted: 2019-09-01
---
import Requirements from '@macros/iam/requirements.mdx'

import image from './assets/scaleway-iothub_network_modal_sigfox.webp'
import image2 from './assets/scaleway-iothub_network_sigfox_devicetype_tab.webp'
import image3 from './assets/scaleway-iothub_network_sigfox_devicetype_callbacks.webp'
import image4 from './assets/scaleway-iothub_network_sigfox_devicetype_new_custom_callback.webp'
import image5 from './assets/scaleway-iothub_network_sigfox_devicetype_callback_form.webp'


The [Sigfox](https://www.sigfox.com/en) network type allows devices communicating with the Sigfox protocol to exchange messages with the IoT Hub. Sigfox will collect messages from your devices, and relay them to your IoT Hub.

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- [Created an IoT Hub](/iot-hub/how-to/create-hub/)
- A [Sigfox account](https://build.sigfox.com/)

<Message type="note">
  The Sigfox network doesn't yet support downlink messages.
</Message>

## How to set up a Sigfox network

<Message type="tip">
  To set up a Sigfox network, a **Sigfox account** is needed. If you do not have an account, take a look at [this page](https://build.sigfox.com/) to get started.
</Message>

1. Click **IoT Hub** in the **Integration Services** section of the side menu. The list of your IoT Hubs displays.
2. Click the name of the IoT Hub that you want to configure. The hub's overview page displays.
3. Click the **Networks** tab on the hub's overview page.
4. Click the **Add network** button to access the network creation wizard.
5. Complete the form by specifying the network's details:
    * Enter a name for your network.
    * Choose Sigfox as the type of network you want to create.
    * Choose a topic prefix your network should publish to. You may leave this empty. All the messages published to this network will have their topics prefixed with this value.
    <Lightbox image={image} alt="" />
6. Click **Create network**. A summary of the network you created, displays. Take note of the two key parameters:
    * The network endpoint.
    * The network secret. Be careful, this secret will **only be shown once**!

This information is required to configure the Sigfox backend.

## How to configure the Sigfox backend

Now you have successfully created your Sigfox network, it is time to configure the Sigfox **callbacks** to relay messages to your IoT Hub.

1. Log into the [Sigfox backend](https://backend.sigfox.com).
2. Go the **DEVICE TYPE** tab
    <Lightbox image={image2} alt="" />
3. Click the **CALLBACKS** entry in the left menu
    <Lightbox image={image3} alt="" />
4. Select the **Custom callback** option
    <Lightbox image={image4} alt="" />
5. Fill-in the form like the example below.
    <Lightbox image={image5} alt="" />

Let us go through each field:

* **Type**: `DATA` `UPLINK` as we do not yet support `BIDIR` callback (will be available soon)
* **Channel**: `URL`.
* **Custom payload config**: Leave it empty.
* **URL pattern**: Enter the network endpoint in this field, for example `https://sigfox.iot.fr-par.scw.cloud`.
* **URL method**: `POST`.
* **Send SNI**: Check this box.
* **Headers**: In this section, we need to define three headers. Do not worry if you only see a single line, once you click it a new empty line will appear.

| Header     | Value                                                                                                                                                                                                 |
|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `X-Secret` | Enter here the network secret that was given when you created the network on your hub.                                                                                                                 |
| `X-Topic`  | Choose here the topic that suits your needs. Note that you may use Sigfox-provided variables here if needed. For example, `app/{device}/payload`. This topic will be prefixed with the network topic. |

- Choose a **content type** and **body** that fits your needs. In the example above we chose to send a JSON payload.

In this example, if the device ID is `A1234B`, the sensor payload is `ABCDEF01`, the `topic` header is `{device}/payload`, and the network prefix is `myapp`, then a message will be received on the `myapp/A1234B/payload` topic, containing the following payload:
```json
{
	"data": "ABCDEF01",
	"id": "A1234B"
}
```