Submitting Workouts to Inform Connect

The workouts resource is a specific workout or fitness event for a user.

It records information about a single time-based physical activity event, including summary information about the workout (for example, step, distance, or energy burned for the entire workout), and segmented metrics that make up each workout (for example, step, distance, or energy burned breakdowns by activity type).

📘
A user can have many workouts per Data Source for a given day. Each submitted event represents a completed workout.

Workouts must include a name and category:

Name: A free form field that defines the workout type for the record.
Category: The category of the workout. Valid values: biking, cardio, running, strength, swimming, walking, other.

Example Workout POST

{
    "log_id": "validic-test-workout-record-1",
    "start_time": "2025-02-24T12:30:09Z",
    "end_time": "2025-02-24T12:30:09Z",
    "utc_offset": -18000,
    "offset_origin": "source",
    "metrics": [
       {
                    "type": "active_duration",
                    "origin": "device",
                    "unit": "s",
                    "value": 2407.0
                },
                {
                    "type": "steps",
                    "origin": "device",
                    "unit": "count",
                    "value": 3638
                },
                {
                    "type": "energy_burned",
                    "origin": "device",
                    "unit": "kcal",
                    "value": 460.0
                },
                {
                    "type": "avg_heart_rate",
                    "origin": "device",
                    "unit": "bpm",
                    "value": 122
                },
                {
                    "type": "heart_rate_zone_high",
                    "origin": "device",
                    "unit": "s",
                    "value": 0.0
                },
                {
                    "type": "heart_rate_zone_low",
                    "origin": "device",
                    "unit": "s",
                    "value": 960.0
                },
                {
                    "type": "heart_rate_zone_medium",
                    "origin": "device",
                    "unit": "s",
                    "value": 1500.0
                },
                {
                    "type": "heart_rate_zone_very_low",
                    "origin": "device",
                    "unit": "s",
                    "value": 0.0
                },
                {
                    "type": "fairly_active_duration",
                    "origin": "device",
                    "unit": "s",
                    "value": 360.0
                },
                {
                    "type": "lightly_active_duration",
                    "origin": "device",
                    "unit": "s",
                    "value": 0.0
                },
                {
                    "type": "very_active_duration",
                    "origin": "device",
                    "unit": "s",
                    "value": 2100.0
                }
    ],
    "source": {
        "type": "validic_connect_test",
        "device": {
            "id": null,
            "model": "Validic Watch",
            "manufacturer": "Validic Inc."
        }
    },
    "type": "workout",
    "category": "other",
    "name": "Running workout on the treadmill",
    "version": "1.0"
}