ROOK now offers seamless integration with Whoop, a leading provider of fitness and wellness tracking. This integration enables users to connect their Whoop accounts directly within the ROOK health platform using their existing credentials (Bring Your Own - BYO), ensuring direct access to their data.
This article provides a step-by-step guide on creating a Whoop developer account and connecting it to the ROOK platform.
Prerequisites for Whoop Integration
Before proceeding, ensure that the response code is 200.
Whoop Application Setup
ROOK recommends creating two separate Whoop applications:
One for sandbox testing
One for production use
This separation helps maintain a clear distinction between testing and live environments. You’ll need to complete Steps 1-6 for each application.
Steps for Integration
Step 1: Create a Whoop Developer Account
To access and integrate Whoop data with ROOK, you must first create a Whoop Developer Account. This account allows you to register your application and obtain the necessary credentials for authorization.
To sign up for a Whoop Developer account:
Visit the Whoop Developer Portal and sign up.
Complete the registration form, providing details such as:
Information about your application
Intended use of the application
Data handling processes
Company details
Step 2: Create an Application
To integrate with the Whoop API:
Navigate to the “Applications” section in the Whoop Developer Portal.
Click Create a New Application (e.g., a web application for website integration).
Provide a name, description, and other relevant details for your application.
Step 3: Generate and Collect Whoop Credentials
Once your Whoop Developer account is approved and your application is created:
Go to the “Applications” section in the Developer Portal.
Locate your newly created application.
Obtain your Client ID and Client Secret—these credentials are essential for integrating your Whoop application with ROOK.
Keep your Client ID and Client Secret secure.
Step 4: Share Credentials with ROOK
Contact your ROOK Customer Success Engineer (CSE) or reach out via the Client Portal chat support widget.
Securely share your Whoop credentials (Client ID and Client Secret) as well as your ROOK credentials using a one-time secret service.
Ensure that you provide the correct credentials for the respective environment (Sandbox or Production).
The CSE will create an internal ticket to generate the Redirect URL and enable the Whoop button in your ROOK client portal.
Once the Redirect URL is ready, your CSE will provide it to you.
Step 5: Configure Redirect URL in Whoop
Return to the “Applications” section in the Whoop Developer Portal. Locate your application and access its configuration settings. In this step, you will need to configure two different URLs to ensure correct integration functionality: the Redirect URL and the Webhook URL.
Redirect URL: The Redirect URL is a crucial component for managing the authorization flow between Whoop and ROOK. It specifies where Whoop should redirect the user after they have authorized the connection. For ROOK integrations, this URL follows a consistent format:
For Sandbox environments: Use https://api.whoop.rook-connect.review/callback-whoop
For Production environments: Use https://api.whoop.rook-connect.com/callback-whoop
You can enter this URL directly into the Redirect URL field in your Whoop application settings.
Webhook URL: The Webhook URL is where ROOK will send real-time updates and notifications related to user data and integration events. This URL is unique to your specific configuration. To obtain your correct Webhook URL, you will need to:
Contact your ROOK Customer Success Engineer (CSE).
Alternatively, you can request it via the Client Portal chat support widget.
Provide the ROOK support team with the necessary information so they can generate the appropriate Webhook URL for your application.
Once you have obtained both the Redirect URL (from the information above) and the Webhook URL (from ROOK support), paste each into the corresponding fields within your Whoop application's configuration settings. Ensuring that both URLs are correctly configured is essential for the Whoop integration to function correctly with ROOK.
Step 6: Authenticate a Test Account Through ROOK
Before going live, test the integration using ROOK’s sandbox environment. This verifies that data flows correctly between Whoop and ROOK without using real user data.
Note: You are currently configuring your sandbox application. Once testing is complete, repeat Steps 1-6 to set up your production application.
Step 7: Request Production Access
After successfully testing the integration in the sandbox environment, you’re ready to move to production with real user data.
To request production access:
In the Whoop Developer Portal, locate your application.
Click “Request Upgrade” on the application page.
This notifies Whoop that you are ready to go live with your integration.
Whoop may review your request before granting approval.
Following these steps will ensure a smooth integration between Whoop and ROOK. If you encounter any issues, reach out to your ROOK Customer Success Engineer or use the Client Portal chat support widget for assistance.
For additional support, refer to the Whoop Developer Documentation or the ROOK Help Center.