Skip to main content
Welcome to Astral. This guide walks you through everything you need to do before your first coached workout — from creating your account to seeing your training plan in the app.
1

Request your verification email

Open the Astral mobile app and enter your email address on the sign-up screen. Astral sends you a verification link that is valid for 24 hours.
You can request up to 3 verification emails per hour for the same address. If you don’t see the email, check your spam folder before requesting another.
Behind the scenes, this call is made to confirm your email:
POST /api/v1/auth/request-verification
Content-Type: application/json

{
  "email": "you@example.com"
}
Response:
{
  "message": "Verification email sent",
  "expires_in": 86400
}
expires_in is in seconds — 86 400 seconds equals 24 hours.
2

Complete signup with your password

Tap the link in your email. It opens the app at a screen where you choose a password. Your password must meet all of the following requirements:
  • At least 8 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one digit
The app sends your verification token and chosen password together to finalize account creation:
POST /api/v1/auth/complete-signup
Content-Type: application/json

{
  "token": "your-verification-token-from-email",
  "password": "YourSecurePass1"
}
Response (201 Created):
{
  "user_id": "abc123",
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_at": 1740000000,
  "credentials": {
    "user_id": "abc123",
    "email": "you@example.com",
    "is_verified": false,
    "is_active": true,
    "roles": ["user"]
  },
  "profile": {
    "user_id": "abc123",
    "email": "you@example.com",
    "username": "yourusername",
    "membership_role": "athlete",
    "status": "active",
    "subscription": {
      "tier": "free",
      "status": "active"
    }
  },
  "is_new_user": true,
  "success": true
}
Save the access_token — the app uses it for all subsequent requests. Your username is auto-generated from your email prefix; you can change it later in Profile Settings.
3

Set your athlete role and profile

After signup, open Profile → Edit Profile in the app. Fill in the fields that help Astral’s AI coach personalize your training:
FieldWhy it matters
First name / Last nameDisplayed to your coach
Display nameShown in the leaderboard and group feed
BioOptional — max 500 characters
Preferred languageen, zh-TW, or ja
Unit systemmetric or imperial
TimezoneUsed to schedule workouts at the right local time
Setting the correct timezone ensures your scheduled workouts appear on the right day and that your AI coach’s weekly summaries align with your local week.
Your account is created with the athlete role by default. If you were invited by a coach, your profile is already linked to their organization — you don’t need to do anything extra.
4

Connect a fitness integration

Astral can automatically import your runs from Strava, Garmin, or Apple Health. Go to Profile → Integrations and tap the service you use.Supported integrations:
  • Strava — OAuth connection; activities sync automatically after each run
  • Garmin — Connect your Garmin account; activities push to Astral after upload
  • Apple Health — Enable on iOS; workouts recorded on Apple Watch sync on app open
You can connect more than one integration. If the same run is imported from two sources, Astral deduplicates it automatically.
Once connected, the integrations field on your profile will reflect the status:
"integrations": {
  "strava":       { "connected": true },
  "garmin":       { "connected": false },
  "apple_health": { "connected": false }
}
5

Find your training plan

If your coach has already assigned a plan to you, it appears on the Training tab the first time you open the app after joining their organization.If you signed up independently (without a coach invitation), you can browse available plans:
  1. Tap Training → Browse Plans
  2. Filter by level (Basic, Intermediate, or Advanced) and type (Run, Bike, Swim)
  3. Tap a plan to preview the week-by-week schedule
  4. Tap Start Plan to activate it
Not sure which level to pick? Tap Calculate my VDOT in the Training tab. Enter a recent race result and Astral will suggest the right training level and set your pace zones automatically.
Once a plan is active, each day’s workout shows up on the home screen. Tap a workout to see the full description, target pace zones, and structured blocks.

​
What’s next

Log an activity

Learn how to manually log a run or review an auto-synced activity.

Understand training plans

See how plans are structured and how AI-generated plans differ from manual ones.

Roles explained

Understand the difference between the Athlete and Coach roles.

Organizations

Learn how coaching clubs work and how to join one.