Withings API icon

Withings API

Withings API Integration

Actions11

Activity → Get Activity

AI-generated

Overview

This node interacts with the Withings API to retrieve user activity data. It supports fetching detailed activity records, summaries, or workout data based on the selected operation. The node is useful for scenarios where users want to integrate Withings activity data into their workflows, such as tracking fitness progress, analyzing workout sessions, or aggregating activity summaries for reporting.

Use Case Examples

  1. A fitness app fetching daily activity data to display user progress.
  2. A health monitoring system retrieving workout details for personalized coaching.
  3. An analytics dashboard aggregating activity summaries for multiple users.

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 record offset for pagination.

Output

JSON

  • success - Indicates if the API call was successful.
  • resource - The resource type, here it will be 'activity'.
  • operation - The operation performed, here 'getactivity'.
  • data - The raw data returned from the Withings API containing the activity information.

Dependencies

  • Requires Withings API credentials, either OAuth2 credentials or a manual access token obtained from a previous node.

Troubleshooting

  • Common issues include token expiration or invalid tokens when using manual authentication. The node attempts to refresh OAuth2 tokens automatically if expired.
  • Error messages from the Withings API are propagated with status codes and error descriptions. Users should ensure valid credentials and correct parameter usage.
  • If the node is set to continue on failure, it returns error details in the output JSON instead of stopping execution.

Links

Discussion