Hevy
App · 20 actions
Work with your Hevy training log: log and update workouts, follow workout changes, build routines and folders, add custom exercises, read an exercise's history and record body measurements.
Actions
| Action | What it does |
|---|---|
| Create custom exercise | Add an exercise of your own to log in workouts and routines. |
| Create routine | Create a workout plan with its exercises and planned sets, in a folder or in My Routines. |
| Create routine folder | Create a folder for routines. |
| Get account | Get the Hevy account the connection acts as: name, username, profile link, units and whether it has Hevy Pro. |
| Get body measurements for a day | Get the body measurements logged on one day. |
| Get exercise | Get one exercise's name, type, muscle groups and equipment. |
| Get exercise history | List every set you have logged of one exercise, with the workout it was in, optionally between two days. |
| Get routine | Get one routine with its folder, exercises and planned sets. |
| Get routine folder | Get one routine folder's title and place in the list. |
| Get workout | Get one workout with its times, exercises and every set. |
| List body measurements | List your body measurements, one entry per day: weight, body fat and sizes. |
| List exercises | List the exercises you can log: Hevy's library and your custom ones, with their muscle groups and equipment. |
| List routine folders | List the folders your routines are filed in. |
| List routines | List your routines with their planned exercises and sets. |
| List workout changes | List workouts logged, changed or deleted since a time, newest first: a changed one comes with the whole workout, a deleted one with its id. |
| List workouts | List your logged workouts with their exercises and sets, newest first. |
| Log body measurements | Record weight, body fat or sizes for a day. |
| Log workout | Log a finished workout with its exercises and sets. |
| Update routine | Change a routine's title, notes or exercises. |
| Update workout | Change a workout's title, times, description or exercises. |
Create custom exercise
Add an exercise of your own to log in workouts and routines.
Inputs
- Name
titletextRequired - The exercise's name.
- What it records
exercise_typetextRequired - What each set of it records, such as weight and reps.One of:
weight_reps(Weight and reps),reps_only(Reps only),bodyweight_reps(Bodyweight reps (with added weight)),bodyweight_assisted_reps(Assisted bodyweight reps),duration,weight_duration(Weight and duration),distance_duration(Distance and duration),short_distance_weight(Weight and short distance). - Equipment
equipment_categorytextRequired - The equipment it uses.One of:
none,barbell,dumbbell,kettlebell,machine,plate,resistance_band(Resistance band),suspension,other. - Primary muscle group
muscle_grouptextRequired - The muscle group it works most.One of:
abdominals,shoulders,biceps,triceps,forearms,quadriceps,hamstrings,calves,glutes,abductors, and 10 more. - Other muscle groups
other_muscleslist - Other muscle groups it works.One or more of:
abdominals,shoulders,biceps,triceps,forearms,quadriceps,hamstrings,calves,glutes,abductors, and 10 more.
Outputs
exercise_templateobject- The new exercise
exercise_template_idtext- The new exercise's id
Example output
{
"exercise_template": {
"equipment": "barbell",
"id": "1234",
"is_custom": true,
"primary_muscle_group": "shoulders",
"secondary_muscle_groups": [
"triceps"
],
"thumbnail_url": null,
"title": "Landmine press",
"type": "weight_reps"
},
"exercise_template_id": "1234"
}Create routine
Create a workout plan with its exercises and planned sets, in a folder or in My Routines.
Inputs
- Title
titletextRequired - The routine's title.
- Exercises
exerciseslistRequired - The exercises planned, in order. Each has an exercise_template_id (from 'List exercises'), optional notes and rest_seconds, and its sets: each set's type (normal, warmup, failure or dropset), weight_kg, reps or a rep_range, distance_meters and duration_seconds.
- Routine folder
folder_idtext - The folder to put it in. Leave empty for My Routines.
- Notes
notestext - Notes on the routine as a whole.
Outputs
routineobject- The routine
Example output
{
"routine": {
"created_at": "2026-11-01T09:00:00Z",
"exercises": [
{
"exercise_template_id": "79D0BB3A",
"index": 0,
"notes": "Pause at the bottom",
"rest_seconds": 90,
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"rep_range": {
"end": 12,
"start": 8
},
"reps": null,
"type": "normal",
"weight_kg": 80
}
],
"superset_id": null,
"title": "Bench Press (Barbell)"
}
],
"folder_id": 42,
"id": "d2a4f1c0-6b7e-4f9a-8c1d-2e3f4a5b6c7d",
"title": "Upper body",
"updated_at": "2026-11-01T09:00:00Z"
}
}Create routine folder
Create a folder for routines. It goes first in your list.
Inputs
- Title
titletextRequired - The folder's title.
Outputs
routine_folderobject- The routine folder
Example output
{
"routine_folder": {
"created_at": "2026-11-01T09:00:00Z",
"id": 42,
"index": 0,
"title": "Push pull legs",
"updated_at": "2026-11-01T09:00:00Z"
}
}Get account
Get the Hevy account the connection acts as: name, username, profile link, units and whether it has Hevy Pro.
Inputs
None.
Outputs
userobject- The connected account
Example output
{
"user": {
"distance_unit": "kilometers",
"id": "9c465af3-de7d-42bc-9c7c-f0170396358b",
"is_pro": true,
"name": "Jo Bloggs",
"url": "https://hevy.com/user/jo",
"username": "jo",
"weight_unit": "kg"
}
}Get body measurements for a day
Get the body measurements logged on one day.
Inputs
- Day
datedateRequired - The day the measurements are for.
Outputs
body_measurementobject- The entry
Example output
{
"body_measurement": {
"abdomen": null,
"chest_cm": 95,
"date": "2026-11-06",
"fat_percent": 18.5,
"hips": null,
"lean_mass_kg": 65,
"left_bicep_cm": 35,
"left_calf": null,
"left_forearm_cm": null,
"left_thigh": null,
"neck_cm": null,
"right_bicep_cm": 35.5,
"right_calf": null,
"right_forearm_cm": null,
"right_thigh": null,
"shoulder_cm": null,
"waist": 80,
"weight_kg": 80.5
}
}Get exercise
Get one exercise's name, type, muscle groups and equipment.
Inputs
- Exercise
exercise_template_idtextRequired - The exercise. Pick one, or give its id from an earlier step.
Outputs
exercise_templateobject- The exercise
Example output
{
"exercise_template": {
"equipment": "barbell",
"id": "D04AC939",
"is_custom": false,
"primary_muscle_group": "quadriceps",
"secondary_muscle_groups": [
"glutes",
"hamstrings"
],
"thumbnail_url": null,
"title": "Squat (Barbell)",
"type": "weight_reps"
}
}Get exercise history
List every set you have logged of one exercise, with the workout it was in, optionally between two days.
Inputs
- Exercise
exercise_template_idtextRequired - The exercise. Pick one, or give its id from an earlier step.
- From
start_datedate - Only workouts on or after this day.
- Until
end_datedate - Only workouts on or before this day.
Outputs
countnumber- How many sets
exercise_historylist- The sets logged
Example output
{
"count": 1,
"exercise_history": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"exercise_template_id": "D04AC939",
"reps": 5,
"rpe": 8,
"set_type": "normal",
"weight_kg": 100,
"workout_end_time": "2026-11-06T18:05:00Z",
"workout_id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"workout_start_time": "2026-11-06T17:00:00Z",
"workout_title": "Friday leg day"
}
]
}Get routine
Get one routine with its folder, exercises and planned sets.
Inputs
- Routine
routine_idtextRequired - The routine. Pick one, or give its id from an earlier step.
Outputs
routineobject- The routine
Example output
{
"routine": {
"created_at": "2026-11-01T09:00:00Z",
"exercises": [
{
"exercise_template_id": "79D0BB3A",
"index": 0,
"notes": "Pause at the bottom",
"rest_seconds": 90,
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"rep_range": {
"end": 12,
"start": 8
},
"reps": null,
"type": "normal",
"weight_kg": 80
}
],
"superset_id": null,
"title": "Bench Press (Barbell)"
}
],
"folder_id": 42,
"id": "d2a4f1c0-6b7e-4f9a-8c1d-2e3f4a5b6c7d",
"title": "Upper body",
"updated_at": "2026-11-01T09:00:00Z"
}
}Get routine folder
Get one routine folder's title and place in the list.
Inputs
- Routine folder
folder_idtextRequired - The routine folder. Pick one, or give its id from an earlier step.
Outputs
routine_folderobject- The routine folder
Example output
{
"routine_folder": {
"created_at": "2026-11-01T09:00:00Z",
"id": 42,
"index": 0,
"title": "Push pull legs",
"updated_at": "2026-11-01T09:00:00Z"
}
}Get workout
Get one workout with its times, exercises and every set.
Inputs
- Workout ID
workout_idtextRequired - The workout's id, from 'List workouts' or an earlier step.
Outputs
workoutobject- The workout
Example output
{
"workout": {
"created_at": "2026-11-06T18:06:00Z",
"description": "Medium intensity, quads first.",
"end_time": "2026-11-06T18:05:00Z",
"exercises": [
{
"exercise_template_id": "D04AC939",
"index": 0,
"notes": "Felt strong",
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"reps": 5,
"rpe": 8,
"type": "normal",
"weight_kg": 100
}
],
"superset_id": null,
"title": "Squat (Barbell)"
}
],
"id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"routine_id": null,
"start_time": "2026-11-06T17:00:00Z",
"title": "Friday leg day",
"updated_at": "2026-11-06T18:06:00Z"
}
}List body measurements
List your body measurements, one entry per day: weight, body fat and sizes. Gets one page; to see more, run it again with the next page number.
Inputs
- Page
pagenumber - Which page to get, from 1. Defaults to the first.At least 1.
- Page size
page_sizenumber - How many to return, 1 to 10. Hevy's default is 10.From 1 to 10.
Outputs
body_measurementslist- The entries
countnumber- How many are on this page
pagenumber- This page's number, from 1
page_countnumber- How many pages there are
Example output
{
"body_measurements": [
{
"abdomen": null,
"chest_cm": 95,
"date": "2026-11-06",
"fat_percent": 18.5,
"hips": null,
"lean_mass_kg": 65,
"left_bicep_cm": 35,
"left_calf": null,
"left_forearm_cm": null,
"left_thigh": null,
"neck_cm": null,
"right_bicep_cm": 35.5,
"right_calf": null,
"right_forearm_cm": null,
"right_thigh": null,
"shoulder_cm": null,
"waist": 80,
"weight_kg": 80.5
}
],
"count": 1,
"page": 1,
"page_count": 1
}List exercises
List the exercises you can log: Hevy's library and your custom ones, with their muscle groups and equipment. Gets one page; to see more, run it again with the next page number.
Inputs
- Page
pagenumber - Which page to get, from 1. Defaults to the first.At least 1.
- Page size
page_sizenumber - How many to return, 1 to 100. Hevy's default is 100.From 1 to 100.
Outputs
countnumber- How many are on this page
exercise_templateslist- The exercises
pagenumber- This page's number, from 1
page_countnumber- How many pages there are
Example output
{
"count": 1,
"exercise_templates": [
{
"equipment": "barbell",
"id": "D04AC939",
"is_custom": false,
"primary_muscle_group": "quadriceps",
"secondary_muscle_groups": [
"glutes",
"hamstrings"
],
"thumbnail_url": null,
"title": "Squat (Barbell)",
"type": "weight_reps"
}
],
"page": 1,
"page_count": 1
}List routine folders
List the folders your routines are filed in. Gets one page; to see more, run it again with the next page number.
Inputs
- Page
pagenumber - Which page to get, from 1. Defaults to the first.At least 1.
- Page size
page_sizenumber - How many to return, 1 to 10. Hevy's default is 10.From 1 to 10.
Outputs
countnumber- How many are on this page
pagenumber- This page's number, from 1
page_countnumber- How many pages there are
routine_folderslist- The routine folders
Example output
{
"count": 1,
"page": 1,
"page_count": 1,
"routine_folders": [
{
"created_at": "2026-11-01T09:00:00Z",
"id": 42,
"index": 0,
"title": "Push pull legs",
"updated_at": "2026-11-01T09:00:00Z"
}
]
}List routines
List your routines with their planned exercises and sets. Gets one page; to see more, run it again with the next page number.
Inputs
- Page
pagenumber - Which page to get, from 1. Defaults to the first.At least 1.
- Page size
page_sizenumber - How many to return, 1 to 10. Hevy's default is 10.From 1 to 10.
Outputs
countnumber- How many are on this page
pagenumber- This page's number, from 1
page_countnumber- How many pages there are
routineslist- The routines
Example output
{
"count": 1,
"page": 1,
"page_count": 1,
"routines": [
{
"created_at": "2026-11-01T09:00:00Z",
"exercises": [
{
"exercise_template_id": "79D0BB3A",
"index": 0,
"notes": "Pause at the bottom",
"rest_seconds": 90,
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"rep_range": {
"end": 12,
"start": 8
},
"reps": null,
"type": "normal",
"weight_kg": 80
}
],
"superset_id": null,
"title": "Bench Press (Barbell)"
}
],
"folder_id": 42,
"id": "d2a4f1c0-6b7e-4f9a-8c1d-2e3f4a5b6c7d",
"title": "Upper body",
"updated_at": "2026-11-01T09:00:00Z"
}
]
}List workout changes
List workouts logged, changed or deleted since a time, newest first: a changed one comes with the whole workout, a deleted one with its id. Gets one page; to see more, run it again with the next page number.
Inputs
- Since
sincedate and time - Only changes after this time. Leave empty for all.
- Page
pagenumber - Which page to get, from 1. Defaults to the first.At least 1.
- Page size
page_sizenumber - How many to return, 1 to 10. Hevy's default is 10.From 1 to 10.
Outputs
countnumber- How many are on this page
eventslist- The changes
pagenumber- This page's number, from 1
page_countnumber- How many pages there are
Example output
{
"count": 2,
"events": [
{
"deleted_at": null,
"id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"type": "updated",
"workout": {
"created_at": "2026-11-06T18:06:00Z",
"description": "Medium intensity, quads first.",
"end_time": "2026-11-06T18:05:00Z",
"exercises": [
{
"exercise_template_id": "D04AC939",
"index": 0,
"notes": "Felt strong",
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"reps": 5,
"rpe": 8,
"type": "normal",
"weight_kg": 100
}
],
"superset_id": null,
"title": "Squat (Barbell)"
}
],
"id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"routine_id": null,
"start_time": "2026-11-06T17:00:00Z",
"title": "Friday leg day",
"updated_at": "2026-11-06T18:06:00Z"
}
},
{
"deleted_at": "2026-11-05T12:00:00Z",
"id": "efe6801c-4aee-4959-bcdd-fca3f272821b",
"type": "deleted",
"workout": null
}
],
"page": 1,
"page_count": 1
}List workouts
List your logged workouts with their exercises and sets, newest first. Gets one page; to see more, run it again with the next page number.
Inputs
- Page
pagenumber - Which page to get, from 1. Defaults to the first.At least 1.
- Page size
page_sizenumber - How many to return, 1 to 10. Hevy's default is 10.From 1 to 10.
Outputs
countnumber- How many are on this page
pagenumber- This page's number, from 1
page_countnumber- How many pages there are
workoutslist- The workouts
Example output
{
"count": 1,
"page": 1,
"page_count": 1,
"workouts": [
{
"created_at": "2026-11-06T18:06:00Z",
"description": "Medium intensity, quads first.",
"end_time": "2026-11-06T18:05:00Z",
"exercises": [
{
"exercise_template_id": "D04AC939",
"index": 0,
"notes": "Felt strong",
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"reps": 5,
"rpe": 8,
"type": "normal",
"weight_kg": 100
}
],
"superset_id": null,
"title": "Squat (Barbell)"
}
],
"id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"routine_id": null,
"start_time": "2026-11-06T17:00:00Z",
"title": "Friday leg day",
"updated_at": "2026-11-06T18:06:00Z"
}
]
}Log body measurements
Record weight, body fat or sizes for a day. If the day already has measurements, only the ones given change.
Inputs
- Day
datedateRequired - The day the measurements are for.
- Weight (kg)
weight_kgnumber - Weight in kg.At least 0.
- Lean mass (kg)
lean_mass_kgnumber - Lean mass in kg.At least 0.
- Body fat (%)
fat_percentnumber - Body fat in %.At least 0.
- Neck (cm)
neck_cmnumber - Neck in cm.At least 0.
- Shoulders (cm)
shoulder_cmnumber - Shoulders in cm.At least 0.
- Chest (cm)
chest_cmnumber - Chest in cm.At least 0.
- Left biceps (cm)
left_bicep_cmnumber - Left biceps in cm.At least 0.
- Right biceps (cm)
right_bicep_cmnumber - Right biceps in cm.At least 0.
- Left forearm (cm)
left_forearm_cmnumber - Left forearm in cm.At least 0.
- Right forearm (cm)
right_forearm_cmnumber - Right forearm in cm.At least 0.
- Abdomen (cm)
abdomennumber - Abdomen in cm.At least 0.
- Waist (cm)
waistnumber - Waist in cm.At least 0.
- Hips (cm)
hipsnumber - Hips in cm.At least 0.
- Left thigh (cm)
left_thighnumber - Left thigh in cm.At least 0.
- Right thigh (cm)
right_thighnumber - Right thigh in cm.At least 0.
- Left calf (cm)
left_calfnumber - Left calf in cm.At least 0.
- Right calf (cm)
right_calfnumber - Right calf in cm.At least 0.
Outputs
body_measurementobject- The day's entry
createdtrue/false- True if the day had no entry before
Example output
{
"body_measurement": {
"abdomen": null,
"chest_cm": 95,
"date": "2026-11-06",
"fat_percent": 18.5,
"hips": null,
"lean_mass_kg": 65,
"left_bicep_cm": 35,
"left_calf": null,
"left_forearm_cm": null,
"left_thigh": null,
"neck_cm": null,
"right_bicep_cm": 35.5,
"right_calf": null,
"right_forearm_cm": null,
"right_thigh": null,
"shoulder_cm": null,
"waist": 80,
"weight_kg": 80.5
},
"created": true
}Log workout
Log a finished workout with its exercises and sets. Weights are in kilograms.
Inputs
- Title
titletextRequired - The workout's title.
- Started
start_timedate and timeRequired - When the workout started.
- Ended
end_timedate and timeRequired - When the workout ended, after it started.
- Exercises
exerciseslistRequired - The exercises done, in order. Each has an exercise_template_id (from 'List exercises'), optional notes, and its sets: each set's type (normal, warmup, failure or dropset; normal if left out), weight_kg, reps, distance_meters, duration_seconds and rpe (6 to 10 in halves from 7).
- Description
descriptiontext - A note about the workout as a whole.
- Private
is_privatetrue/false - Keep the workout off your followers' feed. Public if left unticked.
Outputs
workoutobject- The workout
Example output
{
"workout": {
"created_at": "2026-11-06T18:06:00Z",
"description": "Medium intensity, quads first.",
"end_time": "2026-11-06T18:05:00Z",
"exercises": [
{
"exercise_template_id": "D04AC939",
"index": 0,
"notes": "Felt strong",
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"reps": 5,
"rpe": 8,
"type": "normal",
"weight_kg": 100
}
],
"superset_id": null,
"title": "Squat (Barbell)"
}
],
"id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"routine_id": null,
"start_time": "2026-11-06T17:00:00Z",
"title": "Friday leg day",
"updated_at": "2026-11-06T18:06:00Z"
}
}Update routine
Change a routine's title, notes or exercises. Only the fields given change.
Inputs
- Routine
routine_idtextRequired - The routine. Pick one, or give its id from an earlier step.
- Title
titletext - A new title. Leave empty to keep it.
- Exercises
exerciseslist - Replace every exercise with these, in the same shape as 'Create routine'. Leave empty to keep them.
- Notes
notestext - New notes. Leave empty to keep them.
Outputs
routineobject- The routine
Example output
{
"routine": {
"created_at": "2026-11-01T09:00:00Z",
"exercises": [
{
"exercise_template_id": "79D0BB3A",
"index": 0,
"notes": "Pause at the bottom",
"rest_seconds": 90,
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"rep_range": {
"end": 12,
"start": 8
},
"reps": null,
"type": "normal",
"weight_kg": 80
}
],
"superset_id": null,
"title": "Bench Press (Barbell)"
}
],
"folder_id": 42,
"id": "d2a4f1c0-6b7e-4f9a-8c1d-2e3f4a5b6c7d",
"title": "Upper body (week 2)",
"updated_at": "2026-11-01T09:00:00Z"
}
}Update workout
Change a workout's title, times, description or exercises. Only the fields given change.
Inputs
- Workout ID
workout_idtextRequired - The workout's id, from 'List workouts' or an earlier step.
- Title
titletext - A new title. Leave empty to keep it.
- Started
start_timedate and time - A new start time. Leave empty to keep it.
- Ended
end_timedate and time - A new end time. Leave empty to keep it.
- Exercises
exerciseslist - Replace every exercise with these, in the same shape as 'Log workout'. Leave empty to keep them.
- Description
descriptiontext - A new description. Leave empty to keep it.
- Visibility
is_privatetextRequired - Who can see the workout after the update. Hevy doesn't report whether a workout is private, so choose each time.One of:
true(Private),false(Public).
Outputs
workoutobject- The workout
Example output
{
"workout": {
"created_at": "2026-11-06T18:06:00Z",
"description": "Medium intensity, quads first.",
"end_time": "2026-11-06T18:05:00Z",
"exercises": [
{
"exercise_template_id": "D04AC939",
"index": 0,
"notes": "Felt strong",
"sets": [
{
"custom_metric": null,
"distance_meters": null,
"duration_seconds": null,
"index": 0,
"reps": 5,
"rpe": 8,
"type": "normal",
"weight_kg": 100
}
],
"superset_id": null,
"title": "Squat (Barbell)"
}
],
"id": "b459cba5-cd6d-463c-abd6-54f8eafcadcb",
"routine_id": null,
"start_time": "2026-11-06T17:00:00Z",
"title": "Leg day (heavy)",
"updated_at": "2026-11-06T18:06:00Z"
}
}