Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Withings oauth2 API

The Withings API uses OAuth 2.0, an industry-standard protocol for authorization. OAuth 2.0 enables your application to access user-specific data with a secure and seamless way without requiring users to share their Withings credentials with your app. The Withings API supports the Authorization Code Flow, which is suitable for server-sideapplications. In this flow, your application will obtain an authorization code from the user, which can then be exchanged for an access token and refresh token. There are two ways to obtain the authorization code: 1. **Web Authorization Flow**: Redirect the user to the Withings authorization endpoint,where they can grant permission for your app to access their Withings data. 2. **Account Creation Flow (contract partners only)**: Obtain the authorizationcode after account creation (Cellular Devices/SDK only) . To use OAuth 2.0 with the Withings API, follow these general steps: 1. **Request user authorization/Create an account**: Use one of the two methodsmentioned above to obtain an authorization code from the user. 2. **Obtain an access token**: Exchange the authorization code for an access tokenand refresh token. 3. **Access the API**: Include the access token in your API requests to access user-specificdata from the Withings API. 4. **Refresh tokens**: Use the refresh token to obtain new access tokens when thecurrent ones expire. Please refer to the appropriate [Integration Guide](https://developer.withings.com/developer-guide/v3/withings-solutions/integration-guides)to know which method you should use.

Withings oauth2 API is one of 18 APIs that Withings publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include oauth2. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 8 JSON Schemas.

This API exposes 7 operations across 7 paths. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against a single base URL, https://wbsapi.withings.net/.

7 operations 7 paths 0 schemas 1 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://wbsapi.withings.net
Resource Areas
1

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 1 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

oauth2 7

The Withings API uses OAuth 2.0, an industry-standard protocol for authorization. OAuth 2.0 enables your application to access user-specific data with a secure and seamless way wi…

GET
https://account.withings.com/oauth2_user/authorize2
Authorization URL
oauth2-authorize 6 params → 200
POST
https://wbsapi.withings.net/v2/oauth2
OAuth 2.0 - Request Access and Refresh Tokens
oauth2-getaccesstoken body → 200
POST
https://wbsapi.withings.net/v2/oauth2
OAuth 2.0 - Retrieve a new authorization code
oauth2-recoverauthorizationcode 5 params → 200
POST
https://wbsapi.withings.net/v2/oauth2
OAuth 2.0 - Get user list
oauth2-listusers 5 params → 200
POST
https://wbsapi.withings.net/v2/oauth2
OAuth 2.0 - Revoke user access
oauth2-revoke 5 params → 200
POST
https://wbsapi.withings.net/v2/oauth2
OAuth 2.0 - Get access to demo account
oauth2-getdemoaccess 5 params → 200
POST
https://wbsapi.withings.net/v2/oauth2
OAuth 2.0 - Create OAuth2.0 application
oauth2-createclient 9 params → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

withings-oauth2-api-openapi.yml Raw ↑

Other APIs Withings publishes across the network.

Withings Mobile SDK
Withings Advanced Research API
Withings answers API
Withings device API
Withings dropshipment API
Withings heart API
Withings measure API
Withings notify API
Withings nudge API
Withings nudgecampaign API
Withings order API
Withings rawdata API