---
title: "Create Hour Record"
method: POST
path: "/api/v1/timetracking/add"
tags: ["Public API", "Hours"]
---

# Create Hour Record

`POST /api/v1/timetracking/add`

Adds a single hour record. Use this endpoint when creating one record at a time. For bulk imports, use create-or-update-time-tracking-hour-records.

OAuth Scopes: time_tracking.write

## Request body

- TimeTrackingRecord
  - `timeTrackingId` string, required — A unique identifier for the record. Use this ID to adjust or delete these hours. It can be any ID you use to track the record up to 36 characters in length. (i.e. UUID).
  - `employeeId` integer, required — The ID of the employee.
  - `divisionId` integer — [Optional] The ID of the division for the employee.
  - `departmentId` integer — [Optional] The ID of the department for the employee.
  - `jobTitleId` integer — [Optional] The ID of the job title for the employee.
  - `payCode` string — [Optional] Only necessary if the payroll provider requires a pay code
  - `dateHoursWorked` string, required — The date the hours were worked. Please use the ISO-8601 date format YYYY-MM-DD.
  - `payRate` number — [Optional] The rate of pay. e.g. $15.00/hour should use 15.00 here. Only necessary if the payroll provider requires a pay rate.
  - `rateType` string, required — The type of hours - regular or overtime. Please use either "REG", "OT", or "DT" here.
  - `hoursWorked` number, required — The number of hours worked.
  - `jobCode` integer — [Optional] A job code.
  - `jobData` string — [Optional] A list of up to four 20 characters max job numbers in comma delimited format with no spaces.

## Response `201`

Record created. Returns the new time tracking ID.

- TimeTrackingIdResponseSchema — Schema for time tracking ID response
  - `id` string — Unique identifier for the time tracking record

## Other responses

- `400` — If any required field is missing, referenced IDs are invalid, or the posted JSON is invalid.
- `403` — Forbidden. Insufficient user permissions.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)