Convex Wearables
Documentation for the Convex component that syncs wearable data into your app.
A Convex component for wearable device integrations. Sync workouts, sleep, time-series metrics, and daily summaries from Garmin, Strava, Whoop, Polar, Suunto, and normalized mobile SDK payloads into a consistent schema.
What you get
- OAuth flows and provider connection lifecycle
- Cloud-provider sync for Garmin, Strava, Whoop, Polar, and Suunto
- Query APIs for workouts, sleep, summaries, and time-series data
- Configurable time-series retention and rollups
- Garmin webhook support and normalized SDK push ingestion for Apple HealthKit, Samsung Health, and Google Health Connect
- A shared storage model that works across syncs, webhooks, and mobile payloads
Start here
Installation
Install the component, mount it in Convex, and create your client.
Quickstart
Start reading workouts, summaries, and time-series data.
Storage Policies
Control raw retention, rollups, presets, and per-user assignment.
Client API
Browse the public query, mutation, and action helpers.
Documentation map
Getting Started
Guides
Reference
Who this is for
This documentation is written for teams integrating wearable data into a Convex backend and wanting:
- a production path for Garmin, Strava, Whoop, Polar, and Suunto
- normalized ingestion for Apple Health, Samsung Health, and Google Health Connect through their own apps
- clear control over time-series row growth and retention cost