Zum Hauptinhalt springen

WHOOP Integration

WHOOP is a subscription-based recovery and strain tracker worn 24/7. vitalera integrates with WHOOP API v2 via the unified connected_accounts framework.


Data types

EndpointData
/recoveryRecovery score 0–100%, resting HR, HRV (RMSSD)
/sleepDuration, stages, sleep efficiency, respiratory rate
/workoutStrain 0–21, avg/max HR, calories, distance
/cyclePhysiological day cycle (wake-to-wake)
/user/body_measurementHeight, weight, max HR

Connection

Standard OAuth 2.0 Authorization Code flow.

curl -X POST https://api.vitalera.io/api/connected-accounts/whoop/oauth/initiate/ \
-H "Authorization: Bearer <user_token>"

Interpreting WHOOP scores

  • Recovery score: 0–100%. Green (67–100%), Yellow (34–66%), Red (0–33%).
  • Strain: 0–21 on the Borg scale. 10+ is a significant cardiovascular workout.

vitalera exposes the raw numeric values; colour bucketing is left to the consumer.


Next steps