Import attendance data

post

https://api.hibob.com/v1/attendance/import/{importMethod}

This endpoint allows you to import attendance punches (entries) for employees.

Before using this endpoint:

Explore Import attendance punches into Bob via Public API for detailed information about this endpoint.
It's important to fully understand how to use this endpoint correctly to avoid errors in the import process.

Path Params

importMethod

string

enum

required

Indicates if the provided data should be processed via an aggregation engine or immediately.

Aggregate - will add the logs to a temporary location, and an aggregation job will process the data asynchronously.

Immediate - will insert the records as-is.

Allowed:

Body Params

idType

string

required

The ID type used to identify the employee. Can be one of: "bobId", "email", "idInCompany", or a custom field.
For custom fields a forward slash separator should be used.
In order to use a specific custom field to identify an employee, for example a custom field called "Payroll integration ID":

Query the field name via the "Get all company fields"
In the response the name will look like "identification.custom.Payroll Integration ID_1RNhIIf"
The value to use should be: "/identification/custom/Payroll Integration ID_1RNhI"

requests

array of objects

required

List of attendance events

requests*

dateTimeFormat

string

Allows to set custom date format for the date-time values sent in the requests

Responses

400

Bad request, see error description.

403

Forbidden. Authorization is implemented using a service user with attendance management permissions.

200Records imported