API Reference
Become a partner

Bulk create attendance entries

post
https://api.hibob.com/v1/attendance/entries

Create one or more attendance entries (time log entries) for employees. Entries must match the reporting method (duration or start-end) and rules of the attendance policy linked to the employee.

Before using this endpoint

  • Read the Explore Attendance API for concepts, usage, rate limits, and permissions.
  • Maximum 100 entries per request.
  • Reporting method:
    • Duration: Use when you only need to log a total amount of time for a day. Send clockInDate (YYYY-MM-DD) and duration (minutes). Maximum 24 hours
    • Start-end: Use when you know the actual start and end times. Send clockInTime (timestamp that includes the date) and optionally clockOutTime. The entry date is taken from clockInTime.
  • Cross-midnight: clockInTime and clockOutTime must be on the same date. Sending an entry where clock-out is on another day than clock-in will return an error. Split cross-midnight work into two entries: one ending at 23:59 and one starting at 00:00 the next day.
Body Params

Request body for creating attendance entries (max 100 items)

items
array
required
length between 1 and 100
Defaults to [object Object]

One or more attendance entries to create. Each item must conform to either duration reporting (date + duration) or start-end reporting (clock-in and optional clock-out). Maximum 100 entries per request.

items*

Attendance entry create item using start-end reporting (clock-in and optional clock-out).

string
enum
required

Must be attendanceEntry

Allowed:
fields
object
required

Fields for an entry using start-end reporting (clock-in and optional clock-out). Required: employeeId, type, reportingMethod (startEnd), clockInTime. clockOutTime is optional—omit it to create an open (clocked-in) entry.

request_metadata
object

Optional metadata for the request

Responses

Updated 1 day ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 1 day ago