RUNALYZE API

Apply for the API

The API is limited to public apps and not meant for private use at the moment. Use the Personal API (per Account) to access the endpoints.
To get the credentials for the API tell us about your app in one or two sentences. Please also send us the callback url and if possible a logo of the app to [email protected].

Promotion

In irregular intervals we post about new/existing compatible apps on Instagram/Facebook and in our newsletters.

Documentation

Authorization

Runalyze uses the authorization standard OAuth2.

Authorize URL

https://runalyze.com/oauth/v2/auth
Example
https://runalyze.com/oauth/v2/auth?response_type=code&client_id={Your Client_ID}&redirect_uri={Your Callback url}

Access Token URL

https://runalyze.com/oauth/v2/token
Example
https://runalyze.com/oauth/v2/token?client_id={client id}&client_secret={client_secret}&grant_type=refresh_token&refresh_token={refresh token}

You will always get a new refresh token, when requesting a new access token.
In case the client connections breaks or there was an hickup at Runalyze there will be a grace period for the old refresh token so you can still request for a short period of time a new access token with it.

Scopes

There are scopes for each action (write, read, delete, patch), but currently the Third-Party API only allows writing data to Runalyze.

• “activity_push” is used to upload activities
• “health_metrics_write” is an alias which contains all needed scopes for writing health metrics

Endpoint Documentation

The documentation is available at https://runalyze.com/doc/api/api. Only the writes endpoints are currently available.