---
updatedAt: 2026-04-28T12:11:21.000Z
---
Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.
# Clock in (create entry)
Create a new attendance entry by clocking in the employee identified by the path. Returns the created entry ID.
# OpenAPI definition
```json
{
"openapi": "3.1.1",
"info": {
"title": "Attendance API",
"contact": {
"name": "Hi Bob, Inc."
},
"description": "Public API for importing attendance entries and managing attendance projects, tasks, and clients. Supports detailed field metadata and flexible filtering.",
"license": {
"name": "Proprietary",
"url": "https://apidocs.hibob.com/docs/api-terms-of-use"
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.hibob.com/v1",
"description": "Production"
},
{
"url": "https://api.sandbox.hibob.com/v1",
"description": "Sandbox"
}
],
"x-readme": {
"metrics-enabled": false
},
"tags": [
{
"name": "Attendance",
"description": "Access attendance entries"
}
],
"paths": {
"/attendance/employees/{employeeId}/entries/clock-in": {
"post": {
"operationId": "post_attendance-employees-employeeid-entries-clock-in",
"tags": [
"Attendance"
],
"summary": "Clock in (create entry)",
"description": "Create a new attendance entry by clocking in the employee identified by the path. Returns the created entry ID. \n",
"parameters": [
{
"name": "employeeId",
"in": "path",
"required": true,
"description": "The employee ID to clock in (e.g. from kiosk or badge identification)",
"schema": {
"type": "string"
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ClockInRequestBody"
},
"examples": {
"clockInWithProjectAndComment": {
"summary": "Clock in with project, task and comment",
"description": "Clock in with optional entryType, project/task and comment. Required field is clockInTime (employeeId is in the URL).",
"value": {
"clockInTime": "2026-02-08T09:01:00",
"entryType": "work",
"projectId": 1682,
"taskId": 5,
"comment": "Starting work on feature X",
"reasonCode": "6317"
}
}
}
}
}
},
"responses": {
"201": {
"description": "Clock-in recorded; returns the new entry ID",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/EntryIdResponse"
}
}
}
},
"400": {
"description": "The request is malformed or includes invalid parameters",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"401": {
"description": "Authentication failed. Check your service user credentials",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"403": {
"description": "The service user or token is missing the required permissions to access the requested data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"404": {
"description": "Feature not enabled for this company",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"429": {
"description": "Rate limit exceeded - see Rate limits",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"500": {
"description": "An unexpected error occurred. Try again or contact support if the issue persists.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
}
},
"security": [
{
"basic": []
},
{
"Bearer": []
}
],
"x-internal": false
}
}
},
"components": {
"securitySchemes": {
"basic": {
"type": "http",
"scheme": "basic",
"description": "Basic HTTP authentication using service user credentials"
},
"Bearer": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "OAuth 2.0",
"description": "OAuth 2.0 authentication using an Access Token is available for registered partners only. Try It! does not support the full HiBob OAuth flow. You can follow these steps to complete the OAuth 2.0 flow in Postman and then paste the token here."
}
},
"schemas": {
"ApiErrorResponse": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Error key identifier"
},
"error": {
"type": "string",
"description": "Human-readable error message"
},
"args": {
"type": "array",
"description": "Optional error arguments providing additional context",
"items": {
"type": "string"
}
}
}
},
"ClockInRequestBody": {
"type": "object",
"required": [
"clockInTime"
],
"properties": {
"clockInTime": {
"type": "string",
"format": "date-time",
"description": "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.",
"example": "2026-01-26T09:00:00"
},
"entryType": {
"type": "string",
"enum": [
"work",
"break"
],
"description": "Entry type; defaults to work"
},
"projectId": {
"type": "integer",
"format": "int64",
"description": "Optional project ID for project tracking. Use the Search projects endpoint to get available project IDs."
},
"taskId": {
"type": "integer",
"format": "int64",
"description": "Optional task ID for task tracking. Use the Search tasks endpoint to get available task IDs."
},
"comment": {
"type": "string",
"description": "Optional free-text comment for the entry (max 300 characters)"
},
"reasonCode": {
"type": "string",
"description": "Optional reason code for the entry. Must be a valid string ID from the company's \"Time Log Entry Reason\" list (timeLogEntryReason). Use the company lists metadata endpoint with list name timeLogEntryReason to retrieve valid reason IDs."
}
},
"description": "Request body for clock-in when using POST /attendance/employees/{employeeId}/entries/clock-in (employeeId is in the path)."
},
"EntryIdResponse": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "The attendance entry ID (created or updated)"
}
},
"description": "Response containing a single attendance entry ID"
}
}
}
}
```