Skip to main content

Connection Problems

Solving issues with connecting health providers to Wellpipe.

WHOOP Authorization Fails​

Symptoms​

  • Redirected to WHOOP but get an error
  • Can't complete the OAuth flow
  • Page shows "Authorization failed" or similar

Solutions​

1. Clear browser state

  • Clear cookies for whoop.com
  • Try an incognito/private browser window
  • Or use a different browser

2. Check WHOOP account

  • Make sure you're logged into the correct WHOOP account
  • Verify your WHOOP membership is active
  • Try logging into whoop.com directly first

3. Check redirect

  • Make sure you're clicking Connect from the Wellpipe dashboard
  • Don't manually navigate to WHOOP's auth page

Token Expired​

Symptoms​

  • Dashboard shows "Token Expired" warning
  • Queries return authentication errors
  • Connection was working before

Why This Happens​

WHOOP access tokens expire after 7 days for security. This is a WHOOP API limitation.

Solution​

  1. Go to app.wellpipe.io
  2. Find the WHOOP card
  3. Click Reconnect
  4. Authorize on WHOOP again

Your new token will be valid for 7 days.

"Not Configured" Status​

Symptoms​

  • WHOOP shows as "Not Connected" in dashboard
  • Never successfully connected

Solutions​

1. Try connecting again

  • Click Connect
  • Complete the OAuth flow on WHOOP
  • Wait for redirect back to Wellpipe

2. Check browser

  • Disable ad blockers temporarily
  • Allow popups from wellpipe.io
  • Try a different browser

3. Check network

  • Ensure you have a stable internet connection
  • Corporate firewalls may block OAuth redirects

Wrong Account Connected​

Symptoms​

  • Data belongs to someone else
  • Connected a family member's or old account

Solution​

  1. Click Disconnect in dashboard
  2. Clear cookies for:
    • whoop.com
    • api.prod.whoop.com
  3. Click Connect again
  4. Log into the correct WHOOP account

Tip: Use an incognito window to ensure you're starting fresh.

WHOOP API Errors​

401 Unauthorized​

Your token is invalid or expired.

  • Fix: Reconnect in dashboard

403 Forbidden​

Your account doesn't have access.

  • Check: WHOOP membership is active
  • Check: Required scopes were granted

429 Rate Limited​

Too many requests to WHOOP API.

  • Wait: A few minutes before trying again
  • Reduce: Query frequency

500/502/503 Server Errors​

WHOOP's servers are having issues.

Connection Works But No Data​

Symptoms​

  • Dashboard shows "Connected"
  • Queries return empty or errors

Possible Issues​

1. No data in WHOOP

  • New WHOOP user? Need at least one night of data
  • Check WHOOP app has data for the date range

2. Data not synced

  • WHOOP takes 15-30 min to process after waking
  • Open WHOOP app to trigger sync

3. Permission scope missing

  • Disconnect and reconnect
  • Make sure all scopes are granted during authorization

Self-Hosted CLI Issues​

Can't start OAuth callback server​

  • Port in use: Try a different port with --port 3001
  • Firewall: Allow local connections on the port
  • Permissions: Run with appropriate permissions

Tokens not saving​

  • File permissions: Check .env file is writable
  • Path: Ensure you're in the correct directory

"Invalid redirect URI"​

  • Your redirect URI doesn't match WHOOP app config
  • Check your WHOOP developer app settings
  • URI must be exactly: http://localhost:3000/callback