Skip to main content

​
About Hevy

Hevy is a workout tracking app for logging strength training. The Serval Hevy integration connects to the Hevy API at api.hevyapp.com using an API key from a Hevy Pro subscription. Once connected, workflows can read workouts, routines, exercise templates, body measurements, and account info for the authenticated user. The integration is marked Beta in Serval’s connect UI. Authentication: API key sent in the api-key HTTP header. Serval stores the key encrypted and attaches it to every request automatically. Data sync: On demand only. There is no background sync — workflows fetch Hevy data live when they run.

​
What the Hevy integration enables

CapabilityDescription
Hevy Workouts bundlePrebuilt workflows to list workouts, fetch a workout by ID, and get the total workout count.
Hevy Routines bundleList routines, fetch a routine by ID, and list routine folders.
Hevy Exercises bundleList exercise templates, fetch a template by ID, and retrieve exercise history with optional date filters.
Hevy Profile & Measurements bundleRead the authenticated user’s profile info and list logged body measurements.
Hevy API requestTyped access to the Hevy API v1 from custom workflows — workouts, routines, exercise templates, and user endpoints supported by your API key.
See Hevy’s developer settings for API key generation requirements.

​
Get your credentials

You need an active Hevy Pro subscription and an API key generated in the Hevy web app.
1

Confirm Hevy Pro

API access requires Hevy Pro. Upgrade in the Hevy app if the developer settings page is unavailable.
2

Open developer settings

In the Hevy web app, go to Settings → Developer.
3

Generate an API key

Create a new API key and copy it immediately.
4

Paste the key into Serval

Use the API Key password field in Serval’s Hevy connect form.
Hevy API keys are tied to the account that created them. Workflows operate on that user’s workout data only.

​
Connect in Serval

1

Open the Hevy connect form

In Serval, add the Hevy integration. It is labeled Beta.
2

API Key (required)

Paste your Hevy API key into the password field. Helper text points to hevy.com/settings?developer.
3

Save and verify

Submit the form. Serval runs four health checks against the Hevy API (see below).
When editing an existing connection, the stored API key is shown obfuscated. Re-paste the full key to rotate it.

​
Verifying the connection

Four health checks run after you connect:
  1. Test Connection — calls GET /v1/user/info. Success includes the authenticated user’s display name. Failure: Unable to connect to Hevy. Please verify your API key is valid and that you have an active Hevy Pro subscription.
  2. List Workouts — fetches a page of logged workouts.
  3. List Routines — fetches saved workout routines.
  4. List Exercise Templates — fetches available exercise templates.
If the connection test fails, confirm Hevy Pro is active and regenerate the API key in Hevy developer settings before updating the integration in Serval.

​
Gotchas and troubleshooting

Without an active Pro subscription, key generation and API calls fail. The connection test message explicitly calls this out.
The shipped Hevy workflow bundles read data only. Creating or editing workouts through Serval requires custom workflows that call write endpoints, if Hevy exposes them for your key.
Hevy list endpoints return paginated results. Prebuilt list workflows handle paging; custom workflows should follow the API’s page parameters until a page returns fewer rows than the limit.
Need help? Contact support@serval.com for assistance with your Hevy integration.