Polar Integration
Polar is the pioneer of optical and chest-strap heart rate monitoring. The vitalera Polar integration uses the AccessLink v3 API with non-expiring access tokens and a transactional read model.
Data types
| Category | Notes |
|---|---|
| Exercises | Duration, HR trace, laps, calories, training load |
| Daily activity | Steps, calories, active time |
| Sleep | Continuity, interruptions, sleep score |
| Heart rate | Continuous HR (where supported by device) |
Connection
Polar OAuth 2.0 requires an extra user registration step after the OAuth exchange — the partner must register the user's polar-user-id against their member-id before calling any data endpoints.
Tokens
Polar tokens do not expire. vitalera stores them indefinitely and refreshes only when the user revokes consent (re-authorisation required).
Initiate
curl -X POST https://api.vitalera.io/api/connected-accounts/polar/oauth/initiate/ \
-H "Authorization: Bearer <user_token>"
Transactional reads
Polar's API uses a transaction model: open a transaction, read the URLs it exposes, then commit to mark them read. vitalera handles this internally; you always see already-committed, normalised data.