Skip to main content

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​

CategoryNotes
ExercisesDuration, HR trace, laps, calories, training load
Daily activitySteps, calories, active time
SleepContinuity, interruptions, sleep score
Heart rateContinuous 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.

Next steps​