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
  2. Add the race you are training for — the countdown starts from there
  3. Connect at least one integration (Apple Health recommended)
  4. Choose whether to turn on countdown notifications
  5. Create an account with Sign in with Apple or email and password

App Navigation:

  • Dashboard Tab: Today's Brief — days to go, key dates, preparation progress, race-day weather, next checklist item, fuel plan, and goal verdict
  • Races Tab: Your upcoming races and race history, with logistics, checklists, pace bands, results, and reflections
  • Progress Tab: Readiness score, training-load trends, heart-rate zones, training heatmap, route history, and race predictions
  • Profile Tab: Settings, integrations, subscription, and sign out

Key Features:

  • Add a Race: Races > + button > Name, date, distance, and location
  • Build a Pace Band: open the race > Pace Band > set your goal time and strategy
  • Plan Fueling: open the race > Fueling > add gels, drinks, and timing cues
  • Build a Checklist: open the race > Checklists > New Checklist
  • Track Logistics: open the race > Race Logistics and Key Dates
  • Log a Manual Run: Progress > All Runs > + button
  • Add the Widget: long-press your Home Screen > Edit > Add Widget > MarathonOS
  • Share Results: open the race > Share button

Tips:

  • Connect Apple Health first for automatic run syncing
  • Set a goal time to unlock the readiness verdict and pace band
  • 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 Profile > Settings > Data > "Clean duplicate runs"
  • 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.

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/

Subscription & Billing

What's free:

Creating races and connecting Apple Health, Strava, or Garmin are free. For the first race you add, unlimited checklists and that race's race report are included at no cost.

What Premium adds:

Race logistics, fueling plans, pace bands, goal analysis, unlimited checklists and race reports across every race, and advanced readiness analytics.

Options:

  • Premium Monthly — $5.99/month, auto-renewing, with a 7-day free trial for eligible new subscribers
  • Premium Annual — $39.99/year, auto-renewing, with a 7-day free trial for eligible new subscribers
  • Race Block Pass — $24.99 for 20 weeks. Does not auto-renew and has no trial; you can buy it again after it expires

Prices are in U.S. dollars and may differ by App Store storefront and local taxes.

Managing or cancelling:

  1. Go to Profile > Settings > Subscription
  2. Tap "Manage Subscription" to open your Apple ID subscription settings
  3. Or go to iOS Settings > [your name] > Subscriptions

Auto-renewing plans renew unless you turn off auto-renew at least 24 hours before the period ends. Cancelling keeps premium active until the end of the period you already paid for. Deleting the app does not cancel a subscription.

Restoring a purchase:

Go to Profile > Settings > Subscription > "Restore Purchases". Make sure you are signed in with the same Apple ID you used for the original purchase.

Refunds:

All purchases are processed by Apple. Refund requests go through reportaproblem.apple.com. We are not able to issue refunds directly.

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 your runs, races, checklists, plans, results, and reflections.

Cancelling a Subscription First:

Deleting your account does not cancel an active subscription. Cancel it in iOS Settings > [your name] > Subscriptions before you delete the account.

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

"Duplicate runs from multiple sources"

  • Go to Profile > Settings > Data > "Clean duplicate runs"
  • Automatic deduplication runs when new data syncs
  • Manual cleanup removes the remaining duplicate entries

"Premium features still locked after purchasing"

  • Go to Profile > Settings > Subscription > "Restore Purchases"
  • Confirm you are signed in with the Apple ID used for the purchase
  • If it still does not unlock, email support@42cal.com with your purchase receipt

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

In the app, go to Profile > Settings > Support & About. "Email Support" opens a pre-addressed message and "Help Center" brings you back to this page.

Include your device model, iOS version, and the app version shown in that same section — it makes troubleshooting much faster.

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