Migrations
Fitness & Health API Migration Guides
Migrating a fitness or health integration is usually a real re-integration: you re-map data fields, stand up new auth, deal with historical data, and ask users to reconnect. Each playbook below takes one move — a deprecation, a switch to or from an aggregator, or an architecture change — and walks it step by step, with links to the decision and integration guides.
Still deciding whether to move or what to move to? Start with the alternatives pages for the decision, or troubleshooting if an API just broke. Once you know the target, each playbook here links to its integration guide.
Platform & deprecation moves
Forced migrations off winding-down APIs.
- How to migrate from Google Fit to Health ConnectMove off the deprecating Google Fit REST and Android APIs to on-device Health Connect: architecture shift, data mapping, re-consent, cut-over.
- Migrating from the Fitbit Web API to the Google Health APIHow to move a Fitbit Web API integration to Google Health API: new OAuth, mandatory re-auth, endpoint mapping, and a parallel-run plan. Verify dates.
- Adding Android to a HealthKit appAdd Android to an iOS HealthKit app: map to Health Connect, choose native vs aggregator, and normalize both on-device stores. Step-by-step playbook.
- Migrate off a deprecated fitness APIMove off any deprecated fitness or health API: inventory, map data and auth, run the successor in parallel, re-consent users, then cut over in waves.
Architecture moves
Change how you source and receive data.
- Consolidate wearables: replace direct integrations with one aggregatorMove from per-vendor Fitbit, Garmin, and Oura integrations to one aggregator: map your schema, run in parallel, re-consent users, and cut over safely.
- Migrate from an aggregator to direct provider integrationsMove wearable providers off a health-data aggregator to direct APIs: re-register apps, re-map raw schemas, re-consent users, and the upkeep you re-own.
- How to switch from one health data aggregator to anotherMoving between health data aggregators (Terra, Junction, Rook, Spike)? Re-map schemas, rewire webhooks, and get users to reconnect. Step-by-step.
- Migrate from polling to webhooks for a fitness APIMove a fitness integration from scheduled polling to webhooks: verify the endpoint, handle notification payloads, add idempotency, keep a fallback poll.
Adapt & keep users connected
Ride out API changes without losing connections.
- Adapting Your Integration to Strava's API ChangesStrava tightened its API and developer program since 2024. How to audit fields, re-consent athletes, and adapt. Verify current terms.
- Keep Users Connected During a Fitness API MigrationVendor-neutral playbook to keep users connected during a fitness API migration: run old and new in parallel, re-consent, migrate in waves.
Frequently asked questions
- Is migrating a fitness API integration hard?
- It's usually a real re-integration, not a config change. Different providers expose different data shapes, auth models, and access rules, so a migration typically means re-mapping fields, standing up a new OAuth flow (or on-device permission), handling historical data, and asking users to reconnect. The playbooks here break each move into steps and flag where the effort actually lands.
- How do I migrate without losing user data or connections?
- Plan for continuity: keep the old integration reading while you stand up the new one, back-fill historical data where the new source allows it, and run a re-consent flow so users authorize the new connection before you cut over. Where possible, migrate users in waves and keep a rollback path. The 'keep users connected' playbook covers the sequencing.
- Should I move to an aggregator or integrate directly?
- An aggregator (Terra, Junction, Rook, Spike) gives you one integration across many devices, which cuts per-vendor work — at a recurring cost and some loss of control. Direct integrations mean more maintenance but no middleman and full access to each provider's data. The direct-to-aggregator and aggregator-to-direct playbooks walk both directions so you can decide by trade-off.
Independent comparison, last reviewed July 20, 2026. Pricing, rate limits, and feature availability change often — confirm current details in each provider’s official documentation before you commit. Product and company names are trademarks of their respective owners; AIFitnessAPI is not affiliated with, endorsed by, or sponsored by any product listed here.