Skip to main content

Connecting WHOOP

Connect your WHOOP account to Wellpipe in about 30 seconds.

Prerequisites​

  • An active WHOOP membership
  • Access to your WHOOP account credentials

Step-by-Step​

1. Go to Your Dashboard​

Visit app.wellpipe.io and sign in if you haven't already.

2. Find WHOOP​

On your dashboard, locate the WHOOP provider card.

3. Click Connect​

Click the Connect button on the WHOOP card.

4. Authorize on WHOOP​

You'll be redirected to WHOOP's authorization page. This is WHOOP's official OAuth page—you're not entering credentials on Wellpipe.

Review the permissions and click Authorize.

5. Return to Dashboard​

After authorizing, you'll be redirected back to your Wellpipe dashboard. The WHOOP card will now show:

  • Connected status
  • Your WHOOP user ID
  • Token expiry date

Permissions Explained​

When you authorize, WHOOP asks you to grant these permissions:

PermissionWhat Wellpipe Can Access
Read ProfileYour name and WHOOP user ID
Read SleepSleep sessions, stages, and scores
Read RecoveryRecovery scores, HRV, and readiness data
Read WorkoutWorkout activities, strain, and heart rate
Read CyclesDaily physiological cycles
Read BodyHeight, weight, and max heart rate
Offline AccessRefresh tokens for automatic renewal

All permissions are read-only. Wellpipe cannot modify any WHOOP data.

Token Expiry​

WHOOP access tokens expire after 7 days. When this happens:

  1. Your data queries will stop working
  2. The dashboard will show a warning
  3. Click Reconnect to re-authorize

We're working on automatic token refresh to eliminate this step.

Disconnecting​

To disconnect WHOOP from Wellpipe:

  1. Go to your dashboard
  2. Find the WHOOP card
  3. Click Disconnect

This revokes Wellpipe's access to your WHOOP data. Your WHOOP data remains unchanged in the WHOOP app.

Multiple WHOOP Accounts​

Currently, Wellpipe supports one WHOOP account per Wellpipe account. If you need to switch accounts:

  1. Disconnect the current WHOOP account
  2. Log out of WHOOP in your browser
  3. Connect with the new WHOOP account

Troubleshooting​

Authorization Failed​

If WHOOP's authorization page shows an error:

  1. Make sure you're logged into the correct WHOOP account
  2. Clear browser cookies and try again
  3. Try an incognito/private browser window

"Connection Expired" Message​

Your WHOOP tokens have expired:

  1. Click Reconnect in the dashboard
  2. Authorize again on WHOOP

Wrong Account Connected​

If you accidentally connected the wrong WHOOP account:

  1. Click Disconnect in the dashboard
  2. Clear WHOOP cookies or use incognito mode
  3. Click Connect and log into the correct account

WHOOP App Works But Wellpipe Doesn't​

The WHOOP app and API are separate systems. If the app works but Wellpipe doesn't:

  1. Check if your tokens have expired (dashboard shows expiry date)
  2. Try reconnecting to get fresh tokens
  3. Verify your WHOOP membership is active

See Troubleshooting for more help.