new
Key Selector

Key Selector is ROOK’s new feature that allows clients to customize the JSON structures they receive. This customization tool solves the challenge of processing unnecessary data volumes by enabling each client to define exactly which variables are relevant to their business model.
Data Overload
ROOK clients previously received complete data structures that included variables not used in their workflows. This resulted in inefficient data processing, higher storage demands, and increased difficulty in filtering critical information within events and summaries across the three health pillars: Body, Physical, and Sleep.
Centralized and Manageable Customization
Key Selector introduces a configuration interface within the ROOK Portal, giving clients full control over their data structure.
Pillar management:
 Enables or disables entire health pillars (Body, Physical, Sleep) with a single click.
Variable control:
 Users can select or exclude specific key groups within each event or summary.
Smart event suppression:
 The system automatically evaluates whether an event should stop being sent if all its keys have been deselected, optimizing webhook traffic.
Pre-validation:
 Includes a JSON preview feature so developers can validate the structure before applying changes in production.
Availability and Rollout
The feature is immediately available as a customization tool within the ROOK Portal. By default, all clients will continue receiving the full data structure to ensure compatibility with existing integrations, with the option to enable customization based on their technical needs.
FAQ
What is Key Selector?
It is a customization tool that allows users to tailor the JSON data structures received through ROOKConnect by enabling or disabling specific variables across each health pillar and data structures such as events and summaries.
What problems does this feature solve?
It eliminates unnecessary processing of irrelevant data and improves efficiency when handling large volumes of downstream information.
Does it have any additional cost?
The feature is available as a customization tool within the ROOK Portal at no additional cost.
How does it affect my existing webhooks?
If all keys within an event are deselected, ROOK will stop sending that event entirely. This change will be reflected in your webhook configuration to avoid unnecessary traffic.
Can I revert changes if I disable a variable by mistake?
Yes. Previously disabled variables can be re-enabled without any issues.
Additionally, the ROOK Portal includes a “Reset” button in each section to restore the default configuration, which includes all keys and data groups.
What happens if ROOK adds new metrics or keys in the future?
To prevent data loss, any new key added to the platform will be enabled by default in your data structure.
Is there a risk of breaking my current integration when enabling Key Selector?
No. The system is fully compatible with existing clients, and by default, complete data is delivered until the user decides to manually exclude elements.
How can I ensure the new JSON will work in my system?
Before saving any changes, the portal provides a preview of the configured JSON and allows it to be downloaded for compatibility testing in your development environment. Changes will also be reflected in the JSON Simulator tool.