Skip to main content

Connecting Garmin Connect

Connect your Garmin Connect account to Wellpipe using your Garmin credentials.

Prerequisites​

  • A Garmin Connect account
  • Access to your Garmin Connect credentials
  • If MFA is enabled, access to your authenticator app or email

How Garmin Authentication Works​

Unlike some providers that use OAuth redirects, Garmin uses credential-based authentication:

  1. You enter your Garmin Connect username and password in Wellpipe
  2. Wellpipe authenticates against Garmin's SSO system
  3. OAuth tokens are generated and stored (your password is never stored)
  4. Tokens remain valid for approximately 1 year

Your credentials are transmitted securely and used only to obtain tokens. They are never stored by Wellpipe.

Step-by-Step​

1. Go to Your Dashboard​

Visit app.wellpipe.io and sign in if you haven't already.

2. Find Garmin Connect​

On your dashboard, locate the Garmin Connect provider card.

3. Click Connect​

Click the Connect button on the Garmin Connect card.

4. Enter Your Credentials​

A modal will appear asking for your Garmin Connect credentials:

  • Email: Your Garmin Connect account email
  • Password: Your Garmin Connect password

Click Connect to proceed.

5. Complete MFA (if enabled)​

If you have two-factor authentication enabled on your Garmin account:

  1. You'll be prompted to enter your MFA code
  2. Check your authenticator app or email for the 6-digit code
  3. Enter the code and click Verify

6. Connection Complete​

After successful authentication:

  • The Garmin card will show Connected status
  • Your Garmin display name will appear
  • Token expiry date will be shown (approximately 1 year)

Security Notes​

Credential Handling​

  • Your username and password are transmitted over HTTPS
  • Credentials are used only to authenticate with Garmin's SSO
  • Credentials are never stored - only the resulting OAuth tokens
  • Tokens are encrypted at rest using AES-256-GCM

Why Credentials Instead of OAuth Redirect?​

Garmin's official OAuth program requires business approval. While we've applied for the Garmin Connect Developer Program, we use SSO authentication in the meantime. This is the same method used by popular open-source Garmin tools.

Once approved for the official program, we'll add OAuth redirect as an option.

Token Expiry​

Garmin tokens remain valid for approximately 1 year. When they expire:

  1. Your data queries will stop working
  2. The dashboard will show a warning
  3. Click Reconnect and enter your credentials again

Because tokens last so long, you shouldn't need to reconnect frequently.

Disconnecting​

To disconnect Garmin Connect from Wellpipe:

  1. Go to your dashboard
  2. Find the Garmin Connect card
  3. Click Disconnect

This removes your tokens from Wellpipe. Your Garmin data remains unchanged in Garmin Connect.

Multiple Garmin Accounts​

Currently, Wellpipe supports one Garmin account per Wellpipe account. If you need to switch accounts:

  1. Disconnect the current Garmin account
  2. Connect with the new Garmin account credentials

Troubleshooting​

"Invalid credentials"​

If authentication fails:

  1. Verify you're using the correct email and password
  2. Try logging into connect.garmin.com directly
  3. Check for typos in your email address
  4. Reset your Garmin password if needed

MFA Not Received​

If you don't receive your MFA code:

  1. Check your spam folder (for email MFA)
  2. Ensure your authenticator app is synced
  3. Try requesting a new code
  4. Verify MFA is set up correctly in Garmin Connect settings

Connection Keeps Failing​

If connection repeatedly fails:

  1. Clear your browser cache and cookies
  2. Try an incognito/private browser window
  3. Check if Garmin Connect is experiencing outages
  4. Ensure your Garmin account is in good standing

See Troubleshooting for more help.