wearlink

Official Python SDK for WearLink — a unified connected-health data API for Garmin, Oura, Fitbit, WHOOP, Polar, Strava, Apple Health, Google Fit, and Samsung Health.

Install

pip install wearlink

Requires Python 3.10+.

Quick start

from wearlink import WearLinkClient

wl = WearLinkClient(api_key="sk-...")

user = wl.users.create({"external_user_id": "abc-123", "email": "jane@example.com"})
token = wl.sdk.create_user_token(user.id, app_id="com.example.myapp")

workouts = wl.data.workouts(
    user.id,
    start="2026-04-01T00:00:00Z",
    end="2026-04-30T23:59:59Z",
)
for w in workouts:
    print(w.type, w.start_datetime, w.duration_seconds)

Webhook signature verification

from flask import Flask, request, abort
from wearlink import verify_webhook_signature

app = Flask(__name__)

@app.post("/webhooks/wearlink")
def handle_webhook():
    ok = verify_webhook_signature(
        request.get_data(),
        request.headers.get("x-webhook-signature"),
        secret=os.environ["WEARLINK_WEBHOOK_SECRET"],
    )
    if not ok:
        abort(401)
    event = request.get_json()
    # handle event["type"] ...
    return "", 200

Error handling

All non-2xx responses raise WearLinkError:

from wearlink import WearLinkError

try:
    wl.users.get("nope")
except WearLinkError as err:
    print(err.status, err.detail)

Context manager

with WearLinkClient(api_key="sk-...") as wl:
    users = wl.users.list(limit=100)

License

MIT