Sign in

v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Attendance

Clock in (create entry)

Create a new attendance entry by clocking in the employee identified by the path. Returns the created entry ID.

post/attendance/employees/{employeeId}/entries/clock-in

Path parameters

employeeIdstring required

The employee ID to clock in (e.g. from kiosk or badge identification)

Request body

clockInTimestring date-time required

Clock-in as a timestamp (date + time) in date-time format (e.g. ISO 8601). The date part of the timestamp must be the current date; past or future dates cause the request to fail.

entryType'work' | 'break'

Entry type; defaults to work

projectIdinteger

Optional project ID for project tracking. Use the <a href="#operation/post_attendance-projects-search">Search projects</a> endpoint to get available project IDs.

taskIdinteger

Optional task ID for task tracking. Use the <a href="#operation/post_attendance-project-tasks-search">Search tasks</a> endpoint to get available task IDs.

commentstring

Optional free-text comment for the entry (max 300 characters)

reasonCodestring

Optional reason code for the entry. Must be a valid string ID from the company's "Time Log Entry Reason" list (timeLogEntryReason). Use the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">company lists metadata endpoint</a> with list name timeLogEntryReason to retrieve valid reason IDs.

Example request

{
  "clockInTime": "2026-01-26T09:00:00"
}

Response

Clock-in recorded; returns the new entry ID

idinteger required

The attendance entry ID (created or updated)