> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threadi.au/llms.txt
> Use this file to discover all available pages before exploring further.

# StopWatch Time Log Schema

> Data schema reference for **StopWatch Time Logs**

<Note>
  * This data schema reference relates only to the **StopWatch Time Log** App Object type, not the legacy **Time Log** Custom Object type
  * Except for `hubspot_owner_id`, only properties unique to **StopWatch Time Logs** are included in this reference. <Tooltip tip="e.g. hs_createdate, hs_lastmodifieddate, hs_object_source_id">All standard HubSpot properties</Tooltip> exist on **StopWatch Time Logs** too, but they aren't listed here.
  * For the full OpenAPI definition, see the [StopWatch OpenAPI YAML](https://docs.threadi.au/apis/stopwatch-openapi.yaml). This reference summarises `components.schemas.Timelog`
</Note>

## Data Object Shape

```json theme={null}
{
  "id": "1234567890",
  "properties": {
    "a552213_record_id": "28270412 -- 2026-03-20 04:22:15.536",
    "a552213_assoc_obj_type": "contact",
    "a552213_assoc_record_id": "9876543210",
    "a552213_first_start_date": "2026-02-27T21:24:18.038Z",
    "a552213_total_minutes": 1440
    ...
  },
  "createdAt": "2026-02-27T21:24:18.038Z",
  "updatedAt": "2026-02-28T21:24:18.038Z",
  "archived": false
}
```

***

## Top-Level Fields

| Name                                      | Type       | Description                                  |
| ----------------------------------------- | ---------- | -------------------------------------------- |
| `id` <Badge color="yellow">Unique</Badge> | `string`   | HubSpot object ID for the time log record    |
| `properties`                              | `object`   | **StopWatch Time Log** properties            |
| `createdAt`                               | `datetime` | Record creation timestamp (UTC, ISO-8601)    |
| `updatedAt`                               | `datetime` | Record last update timestamp (UTC, ISO-8601) |
| `archived`                                | `boolean`  | Whether the record is archived in HubSpot    |

***

## Properties (`properties`)

### Identity, Association & Ownership

| Label                                                                                                                                                                                         | Name                                                     | Type                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <Tooltip tip="StopWatch Time Log record primary property and title identifier">StopWatch Record ID</Tooltip>                                                                                  | `a552213_record_id` <Badge color="yellow">Unique</Badge> | `string`                                                                                                                                                  |
| <Tooltip tip="Associated HubSpot object type">Associated Object Type</Tooltip>                                                                                                                | `a552213_assoc_obj_type`                                 | `enumeration` <Badge color="blue"><Tooltip tip="contact, company, deal, ticket, appointment, course, listing, project, service">Options</Tooltip></Badge> |
| <Tooltip tip="Associated HubSpot record ID">Associated Record ID</Tooltip>                                                                                                                    | `a552213_assoc_record_id`                                | `string`                                                                                                                                                  |
| <Tooltip tip="Identification tag used by 'Workflow-Managed Time Logs'. Only relevant for Time Logs created via our HubSpot Custom Workflow Actions.">Workflow Managed Tag</Tooltip>           | `a552213_workflow_managed_tag`                           | `string`                                                                                                                                                  |
| <Tooltip tip="The owner of the Time Log record. By default, this is set to the HubSpot User who submitted the time tracking session(s) contained within the Time Log record.">Owner</Tooltip> | `hubspot_owner_id`                                       | `enumeration` <Badge color="blue"><Tooltip tip="HubSpot Users">Options</Tooltip></Badge>                                                                  |

***

### 1 Time Log Per Session Properties

<Info>
  Only available for our 💫 **Unlimited** and 👥 **Team** subscribers
</Info>

| Label                                                                                                                                        | Name                    | Type                                                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------ |
| <Tooltip tip="Category, selected by users when they submit a '1 Time Log Per Session' time tracking session">Category</Tooltip>              | `a552213_category_text` | `enumeration` <Badge color="blue"><Tooltip tip="Managed by Admins in App Settings">Options</Tooltip></Badge> |
| <Tooltip tip="Free-text description, input by users when they submit a '1 Time Log Per Session' time tracking session">Description</Tooltip> | `a552213_description`   | `string`                                                                                                     |

***

### Session State & Dates

| Label                                                                                | Name                       | Type       |
| ------------------------------------------------------------------------------------ | -------------------------- | ---------- |
| <Tooltip tip="Whether the StopWatch timer is active">Stopwatch Active</Tooltip>      | `a552213_toggle`           | `boolean`  |
| <Tooltip tip="First StopWatch timer start timestamp">First Start Date</Tooltip>      | `a552213_first_start_date` | `datetime` |
| <Tooltip tip="First StopWatch timer stop timestamp">First Stop Date</Tooltip>        | `a552213_first_end_date`   | `datetime` |
| <Tooltip tip="Most recent StopWatch timer start timestamp">Last Start Date</Tooltip> | `a552213_last_start_date`  | `datetime` |
| <Tooltip tip="Most recent StopWatch timer stop timestamp">Last Stop Date</Tooltip>   | `a552213_last_end_date`    | `datetime` |
| <Tooltip tip="Count of time tracking sessions">Number of Sessions</Tooltip>          | `a552213_num_sessions`     | `number`   |

***

### Date Aggregations

<Info>
  Only populated if at least one of the following user-specific settings is enabled:

  * 1 Time Log Per Session
  * Split Time Logs By Week
  * Split Time Logs By Month
</Info>

| Label                                                                                                                   | Name                 | Type   |
| ----------------------------------------------------------------------------------------------------------------------- | -------------------- | ------ |
| <Tooltip tip="Week aggregation anchor date (representing Monday of the given week)">Time Log Week of Year</Tooltip>     | `a552213_week_year`  | `date` |
| <Tooltip tip="Month aggregation anchor date (representing the 1st of the given month)">Time Log Month of Year</Tooltip> | `a552213_month_year` | `date` |

***

### Total Tracked Time Durations

| Label                                                                                | Name                      | Type     |
| ------------------------------------------------------------------------------------ | ------------------------- | -------- |
| <Tooltip tip="Total tracked time (minutes)">Total Tracked Time Minutes</Tooltip>     | `a552213_total_minutes`   | `number` |
| <Tooltip tip="Total tracked time (hours)">Total Tracked Time Hours</Tooltip>         | `a552213_total_hours`     | `number` |
| <Tooltip tip="Total tracked time (days)">Total Tracked Time Days</Tooltip>           | `a552213_total_days`      | `number` |
| <Tooltip tip="Total tracked time (years)">Total Tracked Time Years</Tooltip>         | `a552213_total_years`     | `number` |
| <Tooltip tip="Total tracked time (decades)">Total Tracked Time Decades</Tooltip>     | `a552213_total_decades`   | `number` |
| <Tooltip tip="Total tracked time (centuries)">Total Tracked Time Centuries</Tooltip> | `a552213_total_centuries` | `number` |

***

### Billable Tracked Time Durations & Metrics

<Info>
  * Only populated for **StopWatch Time Logs** where at least 1 related time tracking session has been marked as 'Billable'
  * **Billable Amount**, **Cost Amount** and **Margin Amount** are only populated for our 💫 **Unlimited** subscribers
</Info>

| Label                                                                                                                                                                       | Name                          | Type     |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | -------- |
| <Tooltip tip="Billable tracked time (minutes)">Billable Tracked Time Minutes</Tooltip>                                                                                      | `a552213_billable_minutes`    | `number` |
| <Tooltip tip="Billable tracked time (hours)">Billable Tracked Time Hours</Tooltip>                                                                                          | `a552213_billable_hours`      | `number` |
| <Tooltip tip="Billable tracked time (days)">Billable Tracked Time Days</Tooltip>                                                                                            | `a552213_billable_days`       | `number` |
| <Tooltip tip="Billable tracked time (years)">Billable Tracked Time Years</Tooltip>                                                                                          | `a552213_billable_years`      | `number` |
| <Tooltip tip="Billable tracked time (decades)">Billable Tracked Time Decades</Tooltip>                                                                                      | `a552213_billable_decades`    | `number` |
| <Tooltip tip="Billable tracked time (centuries)">Billable Tracked Time Centuries</Tooltip>                                                                                  | `a552213_billable_centuries`  | `number` |
| <Tooltip tip="Billable monetary amount (in default HubSpot currency)">Billable Amount</Tooltip>                                                                             | `a552213_billable_amount`     | `number` |
| <Tooltip tip="Cost monetary amount">Cost Amount</Tooltip>                                                                                                                   | `a552213_cost_amount`         | `number` |
| <Tooltip tip="Billable Amount - Cost Amount">Margin Amount</Tooltip> <Badge color="purple">Calculated</Badge>                                                               | `a552213_margin_amount`       | `number` |
| <Tooltip tip="Billable ratio as decimal: Billable Tracked Time Minutes / Total Tracked Time Minutes">Billable Percentage</Tooltip> <Badge color="purple">Calculated</Badge> | `a552213_billable_percentage` | `number` |

***

### Time Log Aggregation Flags

| Label                                                                                                                                                                                                                   | Name                                         | Type      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | --------- |
| <Tooltip tip="Indicates the '1 Time Log Per Session' user-specific setting was enabled when the given StopWatch Time Log was created">Is 1 Time Log Per Session Record</Tooltip>                                        | `a552213_is_one_time_log_per_session_record` | `boolean` |
| <Tooltip tip="Indicates the 'Split Time Logs By Week' user-specific setting was enabled when the given StopWatch Time Log was created">Is Split Week Record</Tooltip> <Badge color="white-destructive">Hidden</Badge>   | `a552213_is_split_week_record`               | `boolean` |
| <Tooltip tip="Indicates the 'Split Time Logs By Month' user-specific setting was enabled when the given StopWatch Time Log was created">Is Split Month Record</Tooltip> <Badge color="white-destructive">Hidden</Badge> | `a552213_is_split_month_record`              | `boolean` |