RUNALYZE API

If you are an individual users you might want to check out the Personal 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

Example

Access Token URL

Example

Revoke URL

Example

Revoke client access by sending a POST request to the revoke endpoint with the token in the token parameter. The token_type_hint parameter must be set to either refresh_token or access_token. Revoking either token removes the full client connection for that account.

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.