Skip to main content

Which testing tools does the ROOK Portal have?

The three testing tools under Tools in the ROOK Portal — Playground, JSON Simulator and Integration Guide — and where each one works.

Written by JP Gomez

The ROOK Portal has three testing tools under Tools. Playground creates a test user and connects it to a wearable through the real OAuth flow. JSON Simulator builds a sample payload and sends it to your Data Webhook without connecting anything. Integration Guide walks you through an SDK or API integration step by step. None of them touch real users, and Playground is not available in Production.


What is the Playground, and what can I test with it?

Tools → Playground (beta) lets you create a test user, connect it to a wearable through the real OAuth flow, and inspect what ROOK produces:

Tab

What it shows

Connections

Authorize or revoke data sources for your test user (Garmin, Oura, Polar, Fitbit, Withings, WHOOP, Dexcom and others).

ROOK Scores

The score ROOK computed for that user.

Health Data

The raw summaries received.

API Reference

The exact endpoints Playground uses, so you can call them yourself.

Two guardrails apply:

  • Configure a Data Webhook first. Without one there is nowhere for the test data to go, and the connection looks fine while nothing ever arrives. See How do I set up webhooks in the ROOK Portal?.

  • Playground is not available in Production, because it creates test users and fake connections and Production users are real people. Use Sandbox.

What does the JSON Simulator do?

Tools → JSON Simulator builds a realistic sample payload without connecting a data source. Pick a data source, health pillar and structure, and the simulator generates a payload matching your current data-structure and add-on settings. You can inspect it, download it, or send it straight to your configured Data Webhook, which must be set up first.

Deliveries from the JSON Simulator are marked as simulated, so they never appear in Monitoring → Logs. See How do I monitor traffic and users in the ROOK Portal?.

What is the Integration Guide?

Tools → Integration Guide (beta) is a step-by-step walkthrough with code snippets and a progress checklist. Choose SDK or API, then your platform — Android, iOS, Flutter, Capacitor or React Native, with Samsung Health, Health Connect and Apple Health variants where relevant. An AI assistant panel is available alongside the guide for questions as you go.

Did this answer your question?