Skip to content

Withings

Modern .NET SDK for Withings generated from the provider's OpenAPI definition with AutoSDK.

Nuget package dotnet License: MIT Discord
Get started Get support

Generated from the source spec

Built from a manually-crafted OpenAPI spec covering Withings's Health API so the SDK stays close to the upstream API surface.

Auto-updated

Designed for fast regeneration and low-friction updates when the upstream API changes without breaking compatibility.

Modern .NET

Targets current .NET practices including nullability, trimming, NativeAOT awareness, and source-generated serialization.

Docs from examples

Examples stay in sync between the README, MkDocs site, and integration tests through the AutoSDK docs pipeline.

Usage

1
2
3
4
using Withings;

// Pass your OAuth2 access token (see Authentication below)
using var client = new WithingsClient(accessToken);

Examples.AIFunctions

1
2
3
// Use Withings tools with any MEAI-compatible AI provider
using var client = new WithingsClient(apiKey: "test");
var tools = client.AsTools();

Generate

Basic example showing how to create a client and make a request.

1
using var client = new WithingsClient(apiKey);

Authentication

Withings uses OAuth 2.0 Authorization Code flow. This SDK handles API calls with a Bearer token — you are responsible for obtaining the access token via OAuth2.

Step 1: Register your application

Register at the Withings Partner Hub to get your client_id and client_secret.

Step 2: Redirect the user to authorize

1
2
3
4
5
6
https://account.withings.com/oauth2_user/authorize2
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &state=RANDOM_STATE
  &scope=user.info,user.metrics,user.activity
  &redirect_uri=YOUR_CALLBACK_URL

Available scopes: user.info, user.metrics, user.activity, user.sleepevents

Step 3: Exchange the authorization code for tokens

1
2
3
4
5
6
7
8
9
POST https://wbsapi.withings.net/v2/oauth2
Content-Type: application/x-www-form-urlencoded

action=requesttoken
&grant_type=authorization_code
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&code=AUTH_CODE_FROM_CALLBACK
&redirect_uri=YOUR_CALLBACK_URL

The response contains access_token (valid ~3 hours) and refresh_token (valid ~1 year).

Step 4: Use the access token

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
using var client = new WithingsClient(accessToken);

// Get body measurements (weight, BP, SpO2, etc.)
var measurements = await client.Measure.MeasureGetmeasAsync(...);

// Get sleep summary
var sleep = await client.Sleep.Sleepv2GetsummaryAsync(...);

// Get daily activity (steps, calories)
var activity = await client.Activity.Measurev2GetactivityAsync(...);

Step 5: Refresh tokens

1
2
3
4
5
6
7
8
POST https://wbsapi.withings.net/v2/oauth2
Content-Type: application/x-www-form-urlencoded

action=requesttoken
&grant_type=refresh_token
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&refresh_token=YOUR_REFRESH_TOKEN

Support

Bugs

Open an issue in tryAGI/Withings.

Ideas and questions

Use GitHub Discussions for design questions and usage help.

Community

Join the tryAGI Discord for broader discussion across SDKs.

Acknowledgments

JetBrains logo

This project is supported by JetBrains through the Open Source Support Program.