HiBob

List HiBob documents for employee. Returns document metadata including name, upload date, folder, and tags. Does not return document contents - use download URL if provided.

Upload document to HiBob employee folder from URL. Specify folder_type (‘shared’ or ‘confidential’). Optionally add tags. Returns uploaded document ID.

Delete HiBob document from employee folder. Requires document_id from list_employee_documents and folder_type (‘shared’ or ‘confidential’). Document deletion is permanent and cannot be undone.

Get HiBob document folder metadata. Returns available folder types and IDs. Use to understand document organization before uploading.

Search HiBob employees.

Get detailed HiBob employee by ID. Returns work info, about section, and custom fields. Specify field IDs to limit response size. Use list_employee_fields to see all available fields.

Create new HiBob employee. Required: email, firstName, surname, site (must be valid list item), startDate. Returns created employee. Use get_named_list with ‘site’ to find valid site values first.

Update HiBob employee fields. Pass field paths and values (e.g., ‘work.title’: ‘Senior Engineer’). Use list_employee_fields to find valid field paths. Returns updated employee record.

Terminate HiBob employee with termination date and optional reason. Sets employee status to terminated and records last day of employment. Cannot be undone via API.

Revoke HiBob employee’s system access. Employee record remains but they cannot log in. Use for immediate access removal without full termination.

Get metadata for all HiBob employee fields. Returns paginated field IDs, names, types, and categories. Use field IDs in search_employees and get_employee. No special permissions required.

Get items from HiBob named list (departments, sites, divisions, etc.).

Add new item to HiBob named list (e.g., add new department or site). Returns updated list with new item. Use get_named_list first to see existing items and avoid duplicates.

Search HiBob goals with filters. Filter by owner_id, goal_type_id, cycle_id, or status. Returns paginated results. Use get_goal_metadata for valid goal_type_id and cycle_id values.

Get HiBob goal metadata (types or cycles). Set metadata_type to ‘goal-types’ for goal types or ‘cycles’ for goal cycles. Use returned IDs when creating goals.

Get HiBob company employee field configuration. Returns all configured employee fields with IDs, types, categories, and whether they track history. Use for understanding data model.

List all HiBob company reports. Returns paginated report IDs, names, descriptions, and categories. Use report ID with download_report or download_report_async.

Download HiBob report synchronously (for small/medium reports). Returns report data as CSV or JSON string. For large reports, use download_report_async instead.

Download HiBob report asynchronously (for large reports). Returns download_url with the report location. Use WebFetch or similar to download the file from the URL.

List all open HiBob tasks across the organization. Returns paginated task title, description, assignee, due date, and workflow info. Use for task management and onboarding tracking.

Get HiBob tasks for specific employee. Filter by task_status (‘open’ or ‘closed’). Returns paginated tasks assigned to or about the employee including onboarding tasks.

Mark HiBob task as complete. Provide task_id from list_tasks or get_employee_tasks. Returns count of tasks updated. Tasks cannot be uncompleted via API.

Submit HiBob time off request.

Get HiBob time off request details by request ID and employee ID. Returns full request including status, dates, policy type, and approver info.

Cancel pending HiBob time off request. Only pending requests can be canceled. Returns canceled request with updated status. Use get_time_off_request to verify status before canceling.

Get HiBob employee time off balance. Returns available, used, and pending balances by policy type. Optionally filter by policy_type or calculate as of specific date.

Adjust HiBob employee time off balance (admin operation). Add or subtract days/hours. Positive values add balance, negative subtract. Provide reason for audit trail.

List all HiBob time off policy types (Vacation, Sick, etc.). Returns policy type codes to use in submit_time_off_request. No parameters needed.

List HiBob time off policies. Returns policy details including accrual settings. Optionally filter by policy_type.

Get HiBob who’s out calendar for date range.

Get HiBob employees out today. Quick view of current absences. Set include_pending=true to include pending requests.

Get HiBob time off request changes since timestamp. Track approvals, rejections, cancellations. Use ISO 8601 timestamp for ‘since’ parameter. Useful for syncing with external systems.