Withings APIInstall

Overview

This node integrates with the Withings API to retrieve user health and activity data. Specifically, for the Measure resource with the Get Intradayactivity operation, it fetches detailed intraday activity data such as minute-by-minute movement or steps recorded by a Withings device.

This node is useful in scenarios where you want to analyze fine-grained daily activity patterns rather than just daily summaries. For example, you could use it to monitor how active a user was during specific hours of the day, detect periods of inactivity, or correlate activity spikes with other events.

Practical examples:

• A fitness app that visualizes hourly step counts or calories burned.
• Health research projects analyzing circadian rhythms or activity trends.
• Personal wellness dashboards showing detailed daily activity breakdowns.

Properties

Output

The node outputs JSON data containing the response from the Withings API for intraday activity. The output structure includes:

• success: Boolean indicating if the request succeeded.
• resource: The resource queried, here always "measure".
• operation: The operation performed, here "getintradayactivity".
• Other fields as returned by the Withings API under body (e.g., intraday activity details).

If the API returns an error, the output will contain:

• success: false
• error: Error message string
• status: API status code
• errorCode: Specific error code from the API (if any)
• resource and operation for context

The node does not output binary data.

Dependencies

• Requires an OAuth2 API credential configured for Withings API access.
• The node makes authenticated HTTP GET requests to Withings endpoints.
• Requires internet connectivity and valid Withings account permissions/scopes.

Troubleshooting

• Authentication errors: If you see errors related to tokens, authorization, or permissions, try reconnecting your Withings account credentials in n8n. Ensure your Withings developer app has the correct scopes enabled.
• API rate limits or temporary failures: The node implements retries with exponential backoff. If failures persist, check Withings API status or reduce request frequency.
• Invalid date formats: Ensure date/time inputs are valid ISO timestamps; otherwise, the API may reject the request.
• Empty or incomplete data: Verify that the requested date range actually contains intraday activity data for the user’s device.

Links and References

• Withings API Documentation
• Withings Intraday Activity Endpoint
• n8n OAuth2 Credential Setup