Skip to main content

API Changelog

This changelog highlights notable changes to the WHOOP Developer Platform, such as new API endpoints or webhook event types.

2026-09-23​

Step Count on Cycles​

Cycles now include the total number of steps taken during the cycle.

  • New field: step_count on the Cycle returned by getCycleById and getCycleCollection. null when no step data exists for the cycle.
  • Scopes: Covered by the existing read:cycles scope — no new scope or re-consent required.
  • Documentation: See Cycle for details.

2025-11-01​

Webhook Updates, New V1 Migration API​

Updated webhook documentation to clarify that v1 webhooks are no longer being published. Provided documentation for new activity mapping endpoint to look up historical v1 activity ids.

2025-08-01​

Webhook Documentation Clarification​

Updated webhook documentation to clarify that v2 recovery webhooks use the UUID of the associated sleep, not the cycle ID.

  • v1 Recovery Webhooks: Continue to use cycle ID as the identifier
  • v2 Recovery Webhooks: Use the UUID of the sleep that the recovery is associated with
  • Documentation: Updated webhook documentation to reflect the correct identifier usage

2025-07-01​

v2 API Launch​

The v2 API is now available, featuring improved data models and new capabilities. All developers are encouraged to migrate from v1.

2024-05-01​

Strength Trainer activities​

Strength Trainer activities are available via the /workout endpoint.

2023-02-01​

De-authorization endpoint​

revokeUserOauthAccess – if a user wants to disable your integration, you can revoke their access token from your application in order to respect their privacy. This will ensure you no longer receive webhooks for this user.

2022-09-01​

Developer Platform Launch 🚀​

WHOOP releases their Developer Platform! Read more about the launch here.