Strava

Strava – Connector Configuration

Step 1: Create a Strava Account & Access API Settings

  • Sign in to your Strava account at Strava

  • Navigate to Strava API Settings

  • You need an existing Strava athlete account to create API applications

⚠️ Note: API applications are tied to your Strava athlete account.

Step 2: Create Your API Application

  1. Create a new application:

    • Click "Create & Manage Your App"

    • Fill in the application details:

      • Application Name (e.g., "My Fitness Integration")

      • Category - Select the most appropriate category for your app

      • Club - Optional, select a club if applicable

      • Website - Your application's website URL

      • Application Description - Describe what your integration does

  2. Application Icon:

    • Upload an icon for your application (optional but recommended)

    • Supported formats: PNG, JPG (recommended size: 124x124 pixels)

Step 3: Configure OAuth Settings

  1. Authorization Callback Domain:

    • Enter your callback domain in the "Authorization Callback Domain" field

    • For Appmixer, use your API domain without the full path:

[YOUR_API_DOMAIN]

Example:

api.appmixer.com

  1. OAuth Redirect URI:

    • Strava will construct the full callback URL

    • The complete redirect URI will be:

https://[YOUR_API_DOMAIN]/auth/strava/callback

Example:

https://api.appmixer.com/auth/strava/callback

Step 4: Copy Your Credentials

After creating your application, you'll see your API credentials:

  • Client ID - Your application's unique identifier

  • Client Secret - Your application's secret key

⚠️ Important: Keep your Client Secret secure and never expose it in client-side code!

Step 5: Understand Strava Scopes

Strava uses the following OAuth scopes:

  • read - Read public profile information

  • read_all - Read all profile information (including private activities)

  • profile:read_all - Read all profile information

  • profile:write - Update profile information

  • activity:read - Read public activities

  • activity:read_all - Read all activities (including private)

  • activity:write - Create and update activities

⚠️ Note: Strava has strict guidelines about data usage. Ensure you comply with their API Agreement.

Step 6: Connector Configuration

  1. Go to the Appmixer BackOffice -> Configuration.

  2. Add new configuration: acme:strava.

  3. Add your clientId and clientSecret keys with values.

alt text
alt text

Step 7: Rate Limits

Rate Limits:

  • Default: 100 requests per 15 minutes, 1000 requests per day

  • Higher limits: Available upon request for approved applications

  • Rate limit headers are included in API responses

Step 8: Going Live & App Review

For Public Applications:

  1. Submit for Review:

    • Applications requesting higher rate limits need approval

    • Provide detailed information about your use case

    • Include screenshots and documentation

  2. Compliance Requirements:

    • Follow Strava's API Agreement

    • Implement proper data handling and privacy measures

    • Display Strava attribution where required

Useful Links

PreviousSquareNextTrello

Last updated

Was this helpful?