Back to home

API documentation

Everything you need to integrate 1well into your application. Our REST API provides unified access to health data from multiple providers.

Getting started

1. Create an account

Sign up for a free 1well account to get your API keys.

2. Authenticate requests

All API requests require HMAC authentication. Include your API key and signature in the request headers.

3. Connect providers

Use the OAuth flow to connect your users to their health data providers like Fitbit, Garmin, and Oura.

4. Query data

Access normalized health metrics through our unified query endpoints.

API reference

Base URL: https://api.onewell.health

GET/api/v1/providers

List all available health data providers

POST/api/v1/providers/{slug}/connect

Initiate OAuth connection for a provider

GET/api/v1/queries/timeseries

Retrieve time-series health metrics

GET/api/v1/queries/workouts

Get workout and activity data

GET/api/v1/queries/sleeps

Get sleep tracking data

POST/api/v1/webhooks

Register a webhook for real-time updates

Need help?

Full API documentation coming soon. Contact us for early access and integration support.