ROOK now offers seamless integration with Dexcom, a leading provider of continuous glucose monitoring (CGM) systems. This integration allows users to connect their Dexcom accounts directly within the ROOK health platform using their existing credentials (Bring Your Own - BYO), providing direct access to their data.
In this article, we provide a step-by-step guide on creating a developer account with Dexcom and connecting it to the ROOK platform
Prerequisites for Dexcom Integration
Ensure the response code is 200.
Dexcom Application Setup: ROOK recommends creating two separate Dexcom applications: one for sandbox testing and one for production use. This helps maintain a clean separation between testing and live environments. You'll need to complete Steps 1-6 for each application.
Steps for Integration
Step 1: Create a Dexcom Developer Account
To access and integrate Dexcom data with ROOK, you'll first need to create a Dexcom Developer Account. This account allows you to register your application and obtain the necessary credentials for authorization.
To sign up for a Dexcom Developer account, complete the following steps:
Visit the Dexcom Developer Portal and sign up for an account.
Complete the registration form with the following information:
Details about your application
Intended use of the application
How you plan to handle the data
Details about your company
Note that Dexcom may schedule a meeting to review your application.
Complete the form thoroughly and accurately.
Step 2: Create an Application
To integrate with the Dexcom API:
Navigate to the "Applications" section within the Developer Portal.
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 Dexcom Credentials
Once your Dexcom Developer account is approved and you've created your application, navigate to the "Applications" section within the Developer Portal.
Locate your newly created application and obtain your unique Client ID and Client Secret. These credentials are essential for connecting your Dexcom application to ROOK.
Keep your Client ID and Client Secret secure.
Step 4: Share Credentials with ROOK
Contact your ROOK Customer Success Engineer (CSE) and share your Client ID and Client Secret with them using a secure, one-time secret service.
The CSE will then create an internal ticket to generate the Redirect URL and enable the Dexcom button on your ROOK client portal.
Once the Redirect URL is generated, your CSE will provide it to you.
Step 5: Configure Redirect URL in Dexcom Sandbox
Return to the "Applications" section within the Dexcom Developer Portal and locate your application.
In your application's configuration settings, find the designated field for the Redirect URL and paste the URL provided by your ROOK CSE. This ensures that authentication requests are properly routed between Dexcom and ROOK.
Step 6: Authenticate a Test Account Through ROOK
Before going live, it's essential to test the integration using a sandbox environment within the ROOK platform. This allows you to verify that data is flowing correctly between Dexcom and ROOK without using real user data.
Dexcom Sandbox Limitations: Please note that due to Dexcom Sandbox limitations, you can only test the integration using test accounts provided by Dexcom. Testing with actual user accounts is not possible in the sandbox environment.
To proceed:
Navigate to the "Dexcom Integration" or "Connections" section in your ROOK client portal.
Follow the prompts to authenticate your Dexcom test account. This process may involve logging in to your Dexcom account and granting ROOK permission to access your data.
During the authentication process, you will encounter a window with a dropdown menu. Select the Dexcom test user you want to connect from this menu.
Note: You are currently configuring your sandbox application. Once you have completed testing, you will repeat Steps 1-6 to set up your production application.
Step 7: Request Production Access
Once you've successfully tested the integration in the sandbox environment, you're ready to move to a live production environment with real user data.
To request production access:
In the Dexcom Developer Portal, locate your application.
Click the "Request Upgrade" button on the application page.
This will notify Dexcom that you're ready to go live with your integration.
Dexcom may review your request and approve it if everything is in order.
Be sure to review Dexcom's criteria for production access before submitting your request.