Withings API icon

Withings API

Withings API Integration

Actions11

Measure → Get Measurements

AI-generated

Overview

This node interacts with the Withings API to retrieve measurement data for a user. It supports fetching various types of health measurements such as weight, height, blood pressure, heart pulse, and more. The node is useful for scenarios where users want to automate the retrieval of health metrics from their Withings devices for further processing or analysis in workflows.

Use Case Examples

  1. A user wants to automatically fetch their weight and heart pulse measurements daily to log them in a health tracking system.
  2. A fitness app integrates this node to pull multiple types of body measurements from Withings devices to provide personalized health insights.

Properties

Name Meaning
Authentication Method Specifies how to authenticate with the Withings API, either using stored OAuth2 credentials or a manual access token from a previous node.
Access Token (From Previous Node) The access token used for manual authentication, typically obtained from a token exchange node. Required if manual authentication is selected.
Additional Fields Optional parameters to refine the data retrieval, including start date, end date, last update timestamp, and offset for pagination.
Measure Type Specifies which types of measurements to retrieve, such as weight, height, fat ratio, blood pressure, heart pulse, temperature, and others.

Output

JSON

  • success - Indicates if the API call was successful.
  • resource - The resource type, here it will be 'measure'.
  • operation - The operation performed, here 'getmeas' for getting measurements.
  • body - The raw response body from the Withings API containing the measurement data.
  • data - The measurement data returned by the API if no body property is present.

Dependencies

  • Withings API OAuth2 credentials or manual access token

Troubleshooting

  • If the node throws an authentication error, ensure the OAuth2 credentials or manual access token are valid and not expired.
  • If the API returns an error status, check the error message for details and verify the request parameters such as date ranges and measure types.
  • Token refresh failures may require reconnecting the Withings account or manually updating credentials.

Links

Discussion