Understanding Whoop Activity Data and Common Integration Issues

Whoop integration works differently from other fitness providers due to limitations in Whoop's API. This article explains how Whoop activity data is processed and addresses common issues you may encounter.

How Whoop Activity Data Works

Unlike other fitness providers, Whoop doesn't have a native concept of daily activity summaries in their API. Instead, we create activity summaries by:

  • Matching workouts to the user's Physiological Cycle data

  • Calculating metrics based on available workout information

  • Waiting for cycle completion to ensure accurate data boundaries

Activity Data Timing

You will receive activity summaries on the day of the activity, containing data from the Physiological Cycle. These summaries are then updated after the cycle is finished with additional fields computed from workouts.

This approach ensures you get timely data while maintaining accuracy once complete cycle information becomes available.

Steps and Distance Data

WHOOP steps use the native step count reported for each cycle, including zero.

When WHOOP does not provide a step count, Junction estimates steps from the distance recorded in walking and running workouts. Workouts without distance data do not contribute to this estimate.

Distance data remains the sum of distances recorded in walking and running workouts, rather than total daily movement.

Calories Data

Since Whoop doesn't return calories directly with workouts, we calculate calories based on a kilojoules conversion from the available energy data.

Troubleshooting Missing Data

If you're experiencing missing activity data:

  1. Check your webhook configuration: Ensure webhook URLs in the Whoop developer portal are correct and unique to your team and environment

  2. Verify BYOO credentials: Make sure your Bring Your Own OAuth credentials are properly configured

  3. Confirm app approval status: Ensure your app has received production approval from Whoop if you're experiencing issues in production

If you're receiving some data (like sleep events) but missing activity data, the integration is likely configured correctly, and the issue may be related to how the specific activity data is being processed.

Expected Data Types

From Whoop integrations, you can expect to receive:

  • daily.data.sleep.created and daily.data.sleep.updated events

  • daily.data.workout.created and daily.data.workout.updated events

  • daily.data.activity.created and daily.data.activity.updated events (normalized data across providers)