Skip to main content

📱 Withings Mobile SDK


In June 2021, a new implementation of the Withings SDK has been launched, and the documentation was updated in consequence. We recommend to use this new implementation in a future release of your mobile application.


Withings allows partners to set up and synchronize devices from their own mobile app, removing the difficulty of setting up the device in the Withings app. The Withings Mobile SDK handles both the installation user interface (UI) and the technology behind the device synchronisation without requiring your application to integrate the technical complexity.

To use this service, end users need to have a compatible smartphone or tablet with Bluetooth or BLE.

Example of Setup UI of a device
Example of Device Settings UI once installed

SDK Architecture

The Withings mobile SDK consists of two parts:

  • Webviews (more information): The partner app opens Withings WebViews. Withings provides two types of WebViews:
    • The Installation WebView, which guides end users through the installation process.
    • The Device Settings Webview, which allows end users to access device settings after installation for each device, such as Wi-Fi configuration update, device screen customization or tracker hands calibration.
  • Native packages (iOS / Android): The partner app embeds a native language package provided by Withings (see below for minimum requirements), allowing the partner app to communicate with Withings products.
Discover the user interface

You can use our Demo Mode to discover the user interface of the Withings mobile SDK.

Note: The demo mode does not use real devices or information. All inputs can be random. The demo mode is reset by clearing the cookies or using the private browsing mode.

Data flow

The data is always synchronized with the Withings Cloud whatever the communication method. Once the data is synchronized, you need to use the Withings Data API to fetch it and synchronize it with your mobile application.

The setup and the synchronization are managed by the Withings server using the Withings proprietary protocol through an end-to-end encrypted funnel to ensure a high level of data protection. This implementation also keeps the native packages of the Withings mobile SDK as light as possible and avoid regular upgrades of your mobile application. Withings also ensures a full compatibility with the past and future device softwares. In addition, new features can be released without any upgrade of your mobile application.

Technical overview of the Withings mobile SDK

Withings compatible devices

The Withings mobile SDK makes it possible to install and use the following products:


You will not benefit from the Withings Mobile SDK privileges if you do not have a Withings contract. Please contact us if you are interested in providing the device setup feature in your native iOS and Android app.


Login required

Please log in to your Developer Dashboard in order to file a request.