---
title: "Get Provider Authorization URL"
method: GET
path: "/api/v1/oauth/{provider}/authorize"
tags: ["External: Providers"]
---

# Get Provider Authorization URL

`GET /api/v1/oauth/{provider}/authorize`

Initiate OAuth flow for a provider.

Returns authorization URL where user should be redirected to log in.

## Path parameters

- `provider` 'apple' | 'samsung' | 'garmin' | 'google' | 'polar' | 'suunto' | 'whoop' | 'strava' | 'oura' | 'fitbit' | 'ultrahuman' | 'sensorbio' | 'unknown' | 'internal', required — Supported data providers.

## Query parameters

- `user_id` string, uuid, required — User ID to connect
- `redirect_uri` string, nullable — Optional redirect URI after authorization

## Response `200`

Successful Response

- AuthorizationURLResponse — Response containing authorization URL for user redirect.
  - `authorization_url` string, required
  - `state` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/versions/37c1c527cd8f/schema)