Skip to content
Basic examples to handle Sigfox downlink requests
PHP JavaScript
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Step by step guide in README + Up to date screenshots Aug 2, 2017
nodejs NodeJS - Fixed downlink data structure Sep 13, 2019
php Merge pull request #1 from masaleiro/masaleirojsonphpfix Aug 2, 2017 README : list nodejs example Aug 2, 2017

Sigfox Downlink Callback

About Sigfox

Sigfox operates a global network, dedicated to the IoT.
Very low energy consumption, allowing devices to last years on battery.

The network is all about small messages (12 bytes of useful payload) every now and then (up to 140 times per day).

As the network is bi-directionnal, you can send data from your server to your devices whenever they ask for an update

Check out our developers portal to get more informations about Sigfox.

Downlink details

A downlink message is a message sent to your device.
Using the Sigfox network, this message can be sent either by the network itself (direct, with a few built-in vars), or by the user's application server (callback)

Each downlink message is an 8-bytes frame.

Every time one of your devices will request a downlink message, the callback URL you defined will be called. You need to send back an HTTP 200 OK response, and the 8 bytes response. In some cases, you may have no data to send, then simply reply with a HTTP 204 No Content. This way, no message will be sent to your device.

When sending back some data, you must comply with the following:

Header : Content-Type: application/json

Response body:

  '{{deviceId}}': {

Set up your downlink callback

  1. Log in your Sigfox Cloud account.

  2. Navigate to the appropriate device type menu

  3. Edit the device type, to set the Downlink mode to callback Device Type Edition

  4. In the Callbacks menu, create a custom callback

Callbacks list Custom Callbacks

  1. Set the following settings
  • Type: DATA / BIDIR
  • Channel: URL
  • Url pattern : Your domain + endpoint
  • Check the POST checkbox
  • Content type : application/json
  • Body : the data that will be sent to your service. Customize to your needs

In this example, the body was set as:

	"data": "{data}"

Callback creation

  1. Activate your downlink callback

By default the BIDIRcallback will be inactive after creation

Downlink Inactive

Click the Downlink picto to activate it.
Bear in mind that only one downlink callback can be active at a time.

Downlink Active


This repository contains boilerplate examples in different languages. The goal is to help you getting started with your favorite language.
Fixes, pull requests, ... are all welcome :)

Available Code Samples



You can’t perform that action at this time.