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

ActionWhat it does
Create custom exerciseAdd an exercise of your own to log in workouts and routines.
Create routineCreate a workout plan with its exercises and planned sets, in a folder or in My Routines.
Create routine folderCreate a folder for routines.
Get accountGet the Hevy account the connection acts as: name, username, profile link, units and whether it has Hevy Pro.
Get body measurements for a dayGet the body measurements logged on one day.
Get exerciseGet one exercise's name, type, muscle groups and equipment.
Get exercise historyList every set you have logged of one exercise, with the workout it was in, optionally between two days.
Get routineGet one routine with its folder, exercises and planned sets.
Get routine folderGet one routine folder's title and place in the list.
Get workoutGet one workout with its times, exercises and every set.
List body measurementsList your body measurements, one entry per day: weight, body fat and sizes.
List exercisesList the exercises you can log: Hevy's library and your custom ones, with their muscle groups and equipment.
List routine foldersList the folders your routines are filed in.
List routinesList your routines with their planned exercises and sets.
List workout changesList 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 workoutsList your logged workouts with their exercises and sets, newest first.
Log body measurementsRecord weight, body fat or sizes for a day.
Log workoutLog a finished workout with its exercises and sets.
Update routineChange a routine's title, notes or exercises.
Update workoutChange a workout's title, times, description or exercises.

Create custom exercise

Add an exercise of your own to log in workouts and routines.

Inputs

NametitletextRequired
The exercise's name.
What it recordsexercise_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).
Equipmentequipment_categorytextRequired
The equipment it uses.One of: none, barbell, dumbbell, kettlebell, machine, plate, resistance_band (Resistance band), suspension, other.
Primary muscle groupmuscle_grouptextRequired
The muscle group it works most.One of: abdominals, shoulders, biceps, triceps, forearms, quadriceps, hamstrings, calves, glutes, abductors, and 10 more.
Other muscle groupsother_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

TitletitletextRequired
The routine's title.
ExercisesexerciseslistRequired
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 folderfolder_idtext
The folder to put it in. Leave empty for My Routines.
Notesnotestext
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

TitletitletextRequired
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

DaydatedateRequired
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

Exerciseexercise_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

Exerciseexercise_template_idtextRequired
The exercise. Pick one, or give its id from an earlier step.
Fromstart_datedate
Only workouts on or after this day.
Untilend_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

Routineroutine_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 folderfolder_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 IDworkout_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

Pagepagenumber
Which page to get, from 1. Defaults to the first.At least 1.
Page sizepage_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

Pagepagenumber
Which page to get, from 1. Defaults to the first.At least 1.
Page sizepage_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

Pagepagenumber
Which page to get, from 1. Defaults to the first.At least 1.
Page sizepage_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

Pagepagenumber
Which page to get, from 1. Defaults to the first.At least 1.
Page sizepage_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

Sincesincedate and time
Only changes after this time. Leave empty for all.
Pagepagenumber
Which page to get, from 1. Defaults to the first.At least 1.
Page sizepage_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

Pagepagenumber
Which page to get, from 1. Defaults to the first.At least 1.
Page sizepage_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

DaydatedateRequired
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

TitletitletextRequired
The workout's title.
Startedstart_timedate and timeRequired
When the workout started.
Endedend_timedate and timeRequired
When the workout ended, after it started.
ExercisesexerciseslistRequired
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).
Descriptiondescriptiontext
A note about the workout as a whole.
Privateis_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

Routineroutine_idtextRequired
The routine. Pick one, or give its id from an earlier step.
Titletitletext
A new title. Leave empty to keep it.
Exercisesexerciseslist
Replace every exercise with these, in the same shape as 'Create routine'. Leave empty to keep them.
Notesnotestext
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 IDworkout_idtextRequired
The workout's id, from 'List workouts' or an earlier step.
Titletitletext
A new title. Leave empty to keep it.
Startedstart_timedate and time
A new start time. Leave empty to keep it.
Endedend_timedate and time
A new end time. Leave empty to keep it.
Exercisesexerciseslist
Replace every exercise with these, in the same shape as 'Log workout'. Leave empty to keep them.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Visibilityis_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"
  }
}

On this page