# Hevy

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/hevy

## Actions

### Create custom exercise

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

**Inputs**

- Name (`title`, text, required): The exercise's name.
- What it records (`exercise_type`, text, required): 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_category`, text, required): The equipment it uses. One of: `none`, `barbell`, `dumbbell`, `kettlebell`, `machine`, `plate`, `resistance_band` (Resistance band), `suspension`, `other`.
- Primary muscle group (`muscle_group`, text, required): 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_muscles`, list): Other muscle groups it works. One or more of: `abdominals`, `shoulders`, `biceps`, `triceps`, `forearms`, `quadriceps`, `hamstrings`, `calves`, `glutes`, `abductors`, and 10 more.

**Outputs**

- `exercise_template` (object): The new exercise
- `exercise_template_id` (text): The new exercise's id

**Example output**

```json
{
  "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 (`title`, text, required): The routine's title.
- Exercises (`exercises`, list, required): 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_id`, text): The folder to put it in. Leave empty for My Routines.
- Notes (`notes`, text): Notes on the routine as a whole.

**Outputs**

- `routine` (object): The routine

**Example output**

```json
{
  "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 (`title`, text, required): The folder's title.

**Outputs**

- `routine_folder` (object): The routine folder

**Example output**

```json
{
  "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**

- `user` (object): The connected account

**Example output**

```json
{
  "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 (`date`, date, required): The day the measurements are for.

**Outputs**

- `body_measurement` (object): The entry

**Example output**

```json
{
  "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_id`, text, required): The exercise. Pick one, or give its id from an earlier step.

**Outputs**

- `exercise_template` (object): The exercise

**Example output**

```json
{
  "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_id`, text, required): The exercise. Pick one, or give its id from an earlier step.
- From (`start_date`, date): Only workouts on or after this day.
- Until (`end_date`, date): Only workouts on or before this day.

**Outputs**

- `count` (number): How many sets
- `exercise_history` (list): The sets logged

**Example output**

```json
{
  "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_id`, text, required): The routine. Pick one, or give its id from an earlier step.

**Outputs**

- `routine` (object): The routine

**Example output**

```json
{
  "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_id`, text, required): The routine folder. Pick one, or give its id from an earlier step.

**Outputs**

- `routine_folder` (object): The routine folder

**Example output**

```json
{
  "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_id`, text, required): The workout's id, from 'List workouts' or an earlier step.

**Outputs**

- `workout` (object): The workout

**Example output**

```json
{
  "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 (`page`, number): Which page to get, from 1. Defaults to the first. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 10. Hevy's default is 10. From 1 to 10.

**Outputs**

- `body_measurements` (list): The entries
- `count` (number): How many are on this page
- `page` (number): This page's number, from 1
- `page_count` (number): How many pages there are

**Example output**

```json
{
  "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 (`page`, number): Which page to get, from 1. Defaults to the first. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 100. Hevy's default is 100. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `exercise_templates` (list): The exercises
- `page` (number): This page's number, from 1
- `page_count` (number): How many pages there are

**Example output**

```json
{
  "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 (`page`, number): Which page to get, from 1. Defaults to the first. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 10. Hevy's default is 10. From 1 to 10.

**Outputs**

- `count` (number): How many are on this page
- `page` (number): This page's number, from 1
- `page_count` (number): How many pages there are
- `routine_folders` (list): The routine folders

**Example output**

```json
{
  "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 (`page`, number): Which page to get, from 1. Defaults to the first. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 10. Hevy's default is 10. From 1 to 10.

**Outputs**

- `count` (number): How many are on this page
- `page` (number): This page's number, from 1
- `page_count` (number): How many pages there are
- `routines` (list): The routines

**Example output**

```json
{
  "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 (`since`, date and time): Only changes after this time. Leave empty for all.
- Page (`page`, number): Which page to get, from 1. Defaults to the first. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 10. Hevy's default is 10. From 1 to 10.

**Outputs**

- `count` (number): How many are on this page
- `events` (list): The changes
- `page` (number): This page's number, from 1
- `page_count` (number): How many pages there are

**Example output**

```json
{
  "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 (`page`, number): Which page to get, from 1. Defaults to the first. At least 1.
- Page size (`page_size`, number): How many to return, 1 to 10. Hevy's default is 10. From 1 to 10.

**Outputs**

- `count` (number): How many are on this page
- `page` (number): This page's number, from 1
- `page_count` (number): How many pages there are
- `workouts` (list): The workouts

**Example output**

```json
{
  "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 (`date`, date, required): The day the measurements are for.
- Weight (kg) (`weight_kg`, number): Weight in kg. At least 0.
- Lean mass (kg) (`lean_mass_kg`, number): Lean mass in kg. At least 0.
- Body fat (%) (`fat_percent`, number): Body fat in %. At least 0.
- Neck (cm) (`neck_cm`, number): Neck in cm. At least 0.
- Shoulders (cm) (`shoulder_cm`, number): Shoulders in cm. At least 0.
- Chest (cm) (`chest_cm`, number): Chest in cm. At least 0.
- Left biceps (cm) (`left_bicep_cm`, number): Left biceps in cm. At least 0.
- Right biceps (cm) (`right_bicep_cm`, number): Right biceps in cm. At least 0.
- Left forearm (cm) (`left_forearm_cm`, number): Left forearm in cm. At least 0.
- Right forearm (cm) (`right_forearm_cm`, number): Right forearm in cm. At least 0.
- Abdomen (cm) (`abdomen`, number): Abdomen in cm. At least 0.
- Waist (cm) (`waist`, number): Waist in cm. At least 0.
- Hips (cm) (`hips`, number): Hips in cm. At least 0.
- Left thigh (cm) (`left_thigh`, number): Left thigh in cm. At least 0.
- Right thigh (cm) (`right_thigh`, number): Right thigh in cm. At least 0.
- Left calf (cm) (`left_calf`, number): Left calf in cm. At least 0.
- Right calf (cm) (`right_calf`, number): Right calf in cm. At least 0.

**Outputs**

- `body_measurement` (object): The day's entry
- `created` (true/false): True if the day had no entry before

**Example output**

```json
{
  "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 (`title`, text, required): The workout's title.
- Started (`start_time`, date and time, required): When the workout started.
- Ended (`end_time`, date and time, required): When the workout ended, after it started.
- Exercises (`exercises`, list, required): 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 (`description`, text): A note about the workout as a whole.
- Private (`is_private`, true/false): Keep the workout off your followers' feed. Public if left unticked.

**Outputs**

- `workout` (object): The workout

**Example output**

```json
{
  "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_id`, text, required): The routine. Pick one, or give its id from an earlier step.
- Title (`title`, text): A new title. Leave empty to keep it.
- Exercises (`exercises`, list): Replace every exercise with these, in the same shape as 'Create routine'. Leave empty to keep them.
- Notes (`notes`, text): New notes. Leave empty to keep them.

**Outputs**

- `routine` (object): The routine

**Example output**

```json
{
  "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_id`, text, required): The workout's id, from 'List workouts' or an earlier step.
- Title (`title`, text): A new title. Leave empty to keep it.
- Started (`start_time`, date and time): A new start time. Leave empty to keep it.
- Ended (`end_time`, date and time): A new end time. Leave empty to keep it.
- Exercises (`exercises`, list): Replace every exercise with these, in the same shape as 'Log workout'. Leave empty to keep them.
- Description (`description`, text): A new description. Leave empty to keep it.
- Visibility (`is_private`, text, required): 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**

- `workout` (object): The workout

**Example output**

```json
{
  "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"
  }
}
```
