42cal logo
42cal
MarathonOS Help Center

MarathonOS Support

Get help with your marathon training app. Connect your devices, troubleshoot syncing issues, and reach our team for personalized support.

Getting Started with MarathonOS

First-Time Setup:

  1. Download MarathonOS from the App Store (currently TestFlight beta)
  2. Create an account with email/password or Sign in with Apple
  3. Complete profile setup (name, coach role if applicable)
  4. Skip or complete onboarding tutorial
  5. Connect at least one integration (HealthKit recommended)

App Navigation:

  • Dashboard Tab: Overview of weekly stats, recent activity, upcoming races
  • Plans Tab: View and create 18-week training plans
  • Logs Tab: Browse all workout logs with filtering and search
  • Progress Tab: Charts showing weekly mileage, PRs, and training load
  • Profile Tab: Settings, integrations, coach connection, sign out

Key Features:

  • Import Races: Dashboard > Import Potential Races (finds race-distance workouts)
  • Create Training Plan: Plans > + button > Choose template or blank
  • Log Manual Workout: Logs > + button > Enter workout details
  • Connect with Coach: Profile > Enter Coach Code > Enter code from coach
  • Share Results: Race detail > Share button or Workout detail > Share button

Tips:

  • Enable HealthKit first for automatic workout sync
  • Training plans auto-calculate start dates based on race date
  • Use "See All" buttons to view complete lists
  • Pull down to refresh any list view
  • Tap charts for detailed breakdowns

Apple HealthKit Integration

HealthKit is the PRIMARY integration for MarathonOS. Connect your Apple Watch workouts automatically.

Connecting HealthKit

MarathonOS integrates with Apple HealthKit to automatically sync your workouts:

To connect HealthKit:

  1. Open MarathonOS app on your iPhone
  2. Navigate to Profile > Settings > Integrations
  3. Tap "Connect HealthKit"
  4. Review requested permissions:
    • Read workouts (running, walking, cycling)
    • Read heart rate data
    • Read workout routes
  5. Tap "Allow" to grant permissions
  6. First sync may take 1-2 minutes for large workout histories

Data Synced from HealthKit:

  • Running workouts (distance, pace, duration)
  • Heart rate (average and max)
  • Workout routes and elevation
  • Calories burned
  • Start/end times

We NEVER write data back to HealthKit or modify your Apple Health data.

Troubleshooting:

  • Activities not syncing? Check Settings > Privacy & Security > Health > MarathonOS and ensure all permissions are enabled
  • Duplicate workouts? Use Settings > Data > Clean Up Duplicates
  • Background sync takes 1-2 hours; use "Sync Now" for immediate updates
  • Apple Watch workouts sync automatically if paired with iPhone

Permissions:

HealthKit data never leaves your device unless synced to MarathonOS servers. We use this data only to populate your training dashboard. Your health data is never shared with advertisers.

Strava Integration

Sync your Strava activities with real-time webhook support for instant updates.

Connecting Strava

To connect:

  1. Open MarathonOS app
  2. Navigate to Profile > Settings > Integrations
  3. Tap "Connect Strava"
  4. You'll be redirected to Strava's authorization page
  5. Review permissions:
    • Read your activities
    • Read your profile information
  6. Tap "Authorize" to connect
  7. First sync imports last 90 days of activities

Data Synced from Strava:

  • Running activities (distance, pace, duration, heart rate)
  • Activity titles and descriptions
  • Kudos and comments
  • Route maps and elevation
  • Training stress scores (if available)

Automatic Sync:

  • New Strava activities appear in MarathonOS within 1-2 minutes via webhooks
  • Manual sync available: Tap "Sync Now" to import last 30 days
  • Background sync every 6-12 hours

Troubleshooting:

  • Connection failed? Check you're using correct Strava credentials
  • Activities not syncing? Try "Disconnect" then reconnect to refresh token
  • Duplicate activities? Automatic deduplication runs when new data arrives
  • Token expires every 6 months; you'll see a notification to reconnect

Privacy:

We only READ your Strava data. We cannot post, delete, or modify activities on your behalf. Disconnect anytime via Integrations settings.

Garmin Connect Integration

Import advanced running dynamics from your Garmin device. Manual sync required.

Connecting Garmin

To connect:

  1. Open MarathonOS app
  2. Navigate to Profile > Settings > Integrations
  3. Tap "Connect Garmin"
  4. You'll be redirected to Garmin Connect sign-in
  5. Enter your Garmin credentials
  6. Grant permissions:
    • Read activities
    • Read profile information
  7. Tap "Allow" to authorize
  8. First sync imports last 30 days of activities

Data Synced from Garmin:

  • All running/cycling activities
  • Advanced running dynamics (cadence, ground contact time, vertical oscillation)
  • Training Load and Recovery Time
  • VO2 Max and fitness estimates
  • Heart rate zones and lactate threshold
  • Route maps and elevation profiles

Manual Sync:

Garmin uses OAuth 1.0a (no automatic webhooks). Tap "Sync Now" to pull latest 30 days. Recommended sync frequency: Daily.

Troubleshooting:

  • Connection failed? Verify Garmin account credentials
  • Activities not appearing? Try manual "Sync Now" button
  • Token expires every 90 days; reconnect when prompted
  • Garmin-specific metrics (Running Dynamics) only appear for compatible devices

Privacy:

We only READ your Garmin data. We cannot delete or modify activities on Garmin Connect. Disconnect anytime via Integrations settings.

COROS Integration

Sync your COROS device workouts including Training Load and Running Power metrics.

Connecting COROS

To connect:

  1. Open MarathonOS on your iPhone
  2. Tap the Profile tab (bottom right)
  3. Tap Settings (gear icon)
  4. Scroll to "Integrations" section
  5. Tap "Connect to COROS"
  6. Log in with your COROS account credentials
  7. Authorize MarathonOS to access your training data
  8. You'll be redirected back to the app
  9. Your activities will begin syncing automatically

Data Synced from COROS:

  • Distance, pace, and duration
  • Heart rate and cadence
  • Training Load and Recovery Time
  • Running Power
  • Elevation and route data

Troubleshooting:

  • "Failed to connect to COROS" - Verify your COROS account credentials are correct
  • "Activities not syncing" - Tap "Sync Now" in Settings to manually trigger sync
  • "Duplicate activities appearing" - Tap "Clean duplicate workouts" in Settings > Data

Permissions Requested:

  • Read access to training activities
  • Read access to user profile information
  • We NEVER request permission to delete or modify your COROS data
Sign in with Apple

MarathonOS supports Sign in with Apple for secure, privacy-focused authentication.

What data does Apple share?

  • Your name (if you choose to share it)
  • Your email address (or Apple's private relay email if you use Hide My Email)
  • A unique user identifier from Apple

Troubleshooting:

  • "Sign in with Apple not working" - Ensure iOS is updated to latest version
  • Check Settings > [Your Name] > Sign in with Apple
  • Try signing out of iCloud and back in
  • If persists, email support@42cal.com with device model and iOS version

We use this information solely to create and authenticate your account. Apple's privacy policy applies: https://www.apple.com/legal/privacy/

Coach Dashboard

Coaches can manage athletes via the web dashboard at coach.42cal.com.

Accessing the Coach Dashboard:

  1. Navigate to coach.42cal.com
  2. Sign in with your MarathonOS credentials
  3. Ensure your profile role is set to "Coach"

Getting Your Coach Code:

  1. Sign in to coach.42cal.com
  2. Your unique coach code displays on the dashboard
  3. Share this code with athletes you want to coach
  4. Athletes enter the code in MarathonOS app > Profile > Enter Coach Code

Troubleshooting:

  • If you see "You must be a coach to access this dashboard", your profile role needs to be updated. Email support@42cal.com with subject "Coach Access Request"
  • Coach codes are permanent and can be shared with multiple athletes
  • To disconnect an athlete, you must ask them to disconnect from their app

What Coaches Can See:

  • All workout logs and training data
  • Race history and performance
  • Training plans and progress
  • Real-time updates via WebSocket connections

Coaches have read-only access (except for private coach notes). Coaches cannot delete or modify athlete workout data.

Account Management

Changing Your Email:

Currently not supported in-app. Email support@42cal.com with subject "Change Account Email" and include your current and new email addresses.

Deleting Your Account:

  1. Go to Profile > Settings
  2. Scroll to bottom
  3. Tap "Delete Account"
  4. Confirm deletion (this is permanent!)
  5. All data will be deleted within 30 days

OR email support@42cal.com with subject "Delete My Account"

Exporting Your Data:

Email support@42cal.com with subject "Data Export Request". We'll send JSON/CSV files within 30 days including all workouts, races, and training plans. Does NOT include coach notes (coaches must request separately).

Switching Between Athlete/Coach Roles:

Email support@42cal.com with subject "Role Change Request". Specify if you want to be athlete, coach, or both. Role changes processed within 1-2 business days.

Common Issues & Solutions

"No workouts appearing after connecting HealthKit"

  • Check iOS Settings > Privacy & Security > Health > MarathonOS permissions
  • Try manual "Sync Now" button
  • Workouts must be running/walking/cycling to appear

"Sign in with Apple not working"

  • Ensure iOS is updated to latest version
  • Check Settings > [Your Name] > Sign in with Apple
  • Try signing out of iCloud and back in

"App crashing on launch"

  • Force quit and relaunch
  • Check App Store for updates
  • Restart your iPhone
  • If persists, email support@42cal.com with iOS version and device model

"Coach dashboard shows 'Not a coach'"

  • Your profile role needs to be updated to 'coach'
  • Email support@42cal.com with subject "Coach Access Request"

"Duplicate workouts from multiple sources"

  • Go to Settings > Data > Clean Up Duplicates
  • Automatic deduplication runs when new data syncs
  • Manual cleanup removes all duplicate entries

"Cannot disconnect from coach"

  • Go to Profile > My Coach (expand section)
  • Tap "Disconnect from Coach" button
  • Confirm in dialog

"Data not syncing to coach dashboard"

  • Check internet connection
  • Verify coach connection is active (Profile > My Coach)
  • Real-time updates may take 1-2 seconds
  • Try refreshing coach dashboard browser page

Frequently Asked Questions

Quickly search for answers to the most common MarathonOS questions.

Was this helpful?

Your feedback helps us prioritize updates to the support center.

Contact Support

Need more help? Reach our support team directly for personalized assistance.

Email Support

Response Time:

Within 24-48 hours (usually faster!)

Business Hours: Monday-Friday, 9am-5pm PST

Email:

support@42cal.com

For Urgent Issues:

  • App crashes: Include device model, iOS version, and what you were doing
  • Data loss: Include approximate time/date of incident
  • Account access: Include email address associated with account
  • Privacy requests: Use subject line "Privacy Request"
In-App Help

For immediate help, tap Settings > Help in the MarathonOS iOS app.

This automatically includes your device info and app version for faster troubleshooting.

We keep a secure log of support requests to spot integration issues early.