Create Clock Entry

post

https://{companyDomain}.bamboohr.com/api/v1/time-tracking/clock-entries

Manually creates a time tracking clock entry (corrections, retroactive entry). Distinct from the real-time clock-in process resource. The parent daily entry and timesheet are resolved (and created if needed) from start + timezone; the entry is rejected with 409 when the resolved timesheet's type does not accept clock entries. Geolocation is persisted only when the employee's configuration has it enabled.

OAuth Scopes: time_tracking:timesheets.write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for manually creating a time tracking clock entry (corrections, retroactive entry). timesheetId and date are derived server-side from start + timezone.

employeeId

integer

required

The employee the clock entry belongs to.

start

date-time

required

Clock-in timestamp (ISO 8601).

end

date-time

required

Clock-out timestamp (ISO 8601). Must be after start.

timezone

string

required

IANA timezone identifier the times are recorded under.

note

Free-text note attached to the entry.

projectId

Project the time was logged against.

taskId

Task within the project.

clockInLocation

Geolocation captured at clock-in.

clockOutLocation

Geolocation captured at clock-out.

Responses

201Clock entry created successfully.

400Malformed request body.

401Unauthorized. Missing or invalid authentication.

403Forbidden. Insufficient permissions.

404No timesheet covering the requested date exists for the employee, or the employee does not exist.

409Conflict. An overlapping entry exists, or the resolved timesheet's type is SINGLE or HOUR (clock entries not accepted).

422Validation error (e.g., missing required fields, end before start, invalid timezone, accuracy greater than 10000).