IMimperfect
health-providers

Initiate Provider Connection

Changed on

Initiate OAuth connection with a health provider.

Returns an authorization URL that the app should open in a browser/webview. The user will authenticate with the provider and be redirected back to the app. Anonymous Firebase tokens are accepted so onboarding can begin before a User exists; identity is resolved on the callback.

post/health-providers/{provider}/connect

Request

  • Base URL
    https://api.imperfect.co (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

provider'garmin' | 'whoop' | 'coros' | 'terra' | 'apple_health' required

Health data providers (OAuth connections).

Headers

x-app-versionstring nullable

Request body

redirect_uristring required

Deep link URI where the app will receive the OAuth callback

Response

Successful Response

authorization_urlstring required

URL to redirect user for authorization

statestring required

State parameter to validate callback

Changes