The HiBob connector lets your AI agent work with HiBob. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 22 tools.
- Tools
- 22
- What they doRead · write · destructive
- 17 · 4 · 117 read4 write1 destructive
- Users sign in with
- Username and password
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the HiBob connection
In AgentKit > Connections, create a HiBob connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_toolhibob_employee_employment_history_listList an employee's employment history entries (contract type, weekly hours, salary pay type over time).Read-onlyList Employee Employment History
List an employee's employment history entries (contract type, weekly hours, salary pay type over time). Returns values[] of employment entries with id, effectiveDate, contract, type, weeklyHours and isCurrent. Use hibob_employee_employment_history_list for contract changes.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
hibob_employee_getRead one employee's fields by employee ID; changes nothing.Read-onlyGet Employee
Read one employee's fields by employee ID; changes nothing. Returns the employee with the requested fields. Use hibob_employee_get when you know the employee ID. Use hibob_people_search to find it by email.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
fieldsarray- Field IDs to return in dot notation (see hibob_people_fields_list), up to 400. Omit for the default set. Example: ["root.id", "root.displayName", "root.email", "work.department", "work.title"]
human_readablestring- REPLACE returns display values instead of IDs for list fields; APPEND returns both. Example: REPLACEone of
REPLACEAPPEND
hibob_employee_lifecycle_listList an employee's lifecycle status history (hired, employed, on leave, terminated).Read-onlyList Employee Lifecycle History
List an employee's lifecycle status history (hired, employed, on leave, terminated). Returns values[] of lifecycle entries with status, effectiveDate and reason. Use hibob_employee_lifecycle_list to see an employee's status changes.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
hibob_employee_tasks_listList the tasks of one employee.Read-onlyList Employee Tasks
List the tasks of one employee. Returns tasks[] with id, title, description, dueDate, status and listName. Use hibob_employee_tasks_list for a person's tasks. Use hibob_task_complete to finish one.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
task_statusstring- open or closed. Example: openone of
openclosed
hibob_employee_work_history_listList an employee's work history entries (title, department, site, manager over time).Read-onlyList Employee Work History
List an employee's work history entries (title, department, site, manager over time). Returns values[] of work entries with id, effectiveDate, title, department, site, reportsTo and isCurrent. Use hibob_employee_work_history_list to see job changes. Use hibob_employee_employment_history_list for contract and hours changes.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
include_archivedboolean- Include archived columns. Example: false
hibob_named_list_getGet one company list by name, such as department, site or title.Read-onlyGet Company List
Get one company list by name, such as department, site or title. Returns the list's name and items with id, value and children. Use hibob_named_list_get to look up valid values for employee fields.
Inputs
list_namestringrequired- List name, such as department, site or title. Example: department
include_archivedboolean- Include archived items. Example: false
hibob_named_lists_listList the company's lists (such as department, site, title) and their items.Read-onlyList Company Lists
List the company's lists (such as department, site, title) and their items. Returns an object keyed by list name, each with its items (id, value, name, archived, children). Use hibob_named_lists_list to see valid values. Use hibob_named_list_get for one list.
Inputs
include_archivedboolean- Include archived items. Example: false
hibob_people_fields_listList all employee fields with their IDs, categories and types.Read-onlyList Employee Fields
List all employee fields with their IDs, categories and types. Returns an array of fields with id, name, category, type, description and historical flag. Use hibob_people_fields_list to get field IDs for hibob_people_search and hibob_employee_update.
Inputs
This tool takes no inputs.
hibob_people_searchSearch employees, returning chosen fields, optionally filtered to one employee ID or email and including inactive employees; changes nothing.Read-onlySearch Employees
Search employees, returning chosen fields, optionally filtered to one employee ID or email and including inactive employees; changes nothing. Returns employees[] with the requested fields (root.id, displayName, email, work, about and so on). Use hibob_people_search to list or find employees. Use hibob_employee_get for one employee by ID.
Inputs
fieldsarray- Field IDs to return in dot notation (see hibob_people_fields_list), up to 400. Omit for the default set. Example: ["root.id", "root.displayName", "root.email", "work.department", "work.title"]
filtersarray- At most one filter, on root.id or root.email with operator equals. Example: [{"fieldPath": "root.email", "operator": "equals", "values": ["jane@example.com"]}]
human_readablestring- REPLACE returns display values instead of IDs for list fields; APPEND returns both. Example: REPLACEone of
REPLACEAPPEND show_inactiveboolean- Include inactive (former) employees. Example: false
hibob_profiles_listList the public profile section of all active employees.Read-onlyList Employee Profiles
List the public profile section of all active employees. Returns employees[] with id, displayName, email, work (title, department, site, manager) and avatar. Use hibob_profiles_list for a quick company directory. Use hibob_people_search for chosen fields or inactive employees.
Inputs
This tool takes no inputs.
hibob_tasks_listList all open tasks in the company (onboarding, offboarding and other workflow tasks).Read-onlyList Open Tasks
List all open tasks in the company (onboarding, offboarding and other workflow tasks). Returns tasks[] with id, title, description, owner, employeeId, requestedFor, dueDate, status and listName. Use hibob_tasks_list for every open task. Use hibob_employee_tasks_list for one employee.
Inputs
This tool takes no inputs.
hibob_timeoff_balance_getGet an employee's time off balance for a policy type on a date.Read-onlyGet Time Off Balance
Get an employee's time off balance for a policy type on a date. Returns the balance with policy, total, used, approved and pending amounts and the unit (days or hours). Use hibob_timeoff_balance_get before submitting a request.
Inputs
datestringrequired- Balance as of this date (YYYY-MM-DD). Example: 2026-12-31
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
policy_typestringrequired- Policy type name. Example: Holiday
hibob_timeoff_out_today_listList who is out of the office today or on a given date.Read-onlyList Out Today
List who is out of the office today or on a given date. Returns outs[] with employeeId, employeeDisplayName, policyTypeDisplayName and portion. Use hibob_timeoff_out_today_list for one day. Use hibob_timeoff_whos_out_list for a range.
Inputs
include_hourlyboolean- Include hourly requests. Example: false
site_idinteger- Only employees of this site ID. Example: 1234
todaystring- Date to check (YYYY-MM-DD); defaults to today in UTC. Example: 2026-11-16
hibob_timeoff_policy_types_listList the names of all time off policy types.Read-onlyList Time Off Policy Types
List the names of all time off policy types. Returns an array of policy type names, such as Holiday and Sick. Use hibob_timeoff_policy_types_list to get the policy_type for requests and balances.
Inputs
This tool takes no inputs.
hibob_timeoff_request_getGet one time off request of an employee.Read-onlyGet Time Off Request
Get one time off request of an employee. Returns the request with requestId, policyTypeDisplayName, type, status, dates, portions and description. Use hibob_timeoff_request_get to check a request's status.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
request_idintegerrequired- Time off request ID. Example: 7841234
hibob_timeoff_requests_changes_listList time off requests created, updated or cancelled in a time range.Read-onlyList Time Off Request Changes
List time off requests created, updated or cancelled in a time range. Returns changes[] with changeType, employeeId, requestId, policyTypeDisplayName, dates and status. Use hibob_timeoff_requests_changes_list to sync time off since a point in time.
Inputs
sincestringrequired- Start of the range (ISO-8601 date-time, within the last 31 days). Example: 2026-11-01T00:00:00Z
include_pendingboolean- Include pending requests. Example: true
tostring- End of the range (ISO-8601 date-time). Example: 2026-11-15T23:59:59Z
hibob_timeoff_whos_out_listList who is out of the office in a date range.Read-onlyList Who's Out
List who is out of the office in a date range. Returns outs[] with employeeId, employeeDisplayName, policyTypeDisplayName, startDate, endDate and portions. Use hibob_timeoff_whos_out_list for team availability over a period. Use hibob_timeoff_out_today_list for a single day.
Inputs
fromstringrequired- Start date (YYYY-MM-DD). Example: 2026-12-21
tostringrequired- End date (YYYY-MM-DD). Example: 2026-12-31
include_hourlyboolean- Include hourly requests. Example: false
include_pendingboolean- Include pending requests. Example: false
hibob_employee_createCreate an employee record in Bob (it does not send an invitation).WriteCreate Employee
Create an employee record in Bob (it does not send an invitation). Returns the created employee with id and the saved fields. Use hibob_employee_create to add a new hire. site, department and title must be values from the company's lists (see hibob_named_list_get).
Inputs
emailstringrequired- Work email, unique in the company. Example: jane.doe@example.com
first_namestringrequired- First name. Example: Jane
sitestringrequired- Site display name from the site list. Example: New York
start_datestringrequired- Employment start date (YYYY-MM-DD). Example: 2026-12-01
surnamestringrequired- Surname. Example: Doe
departmentstring- Department from the department list. Example: Engineering
titlestring- Job title from the title list. Example: Software Engineer
hibob_employee_updateUpdate an employee's fields, written in the nested shape hibob_people_search returns.WriteUpdate Employee
Update an employee's fields, written in the nested shape hibob_people_search returns. Returns an empty response (HTTP 200, or 304 when nothing changed). Use hibob_employee_update to change personal or work fields. Use hibob_people_fields_list to find field IDs; history tables such as work and employment have their own endpoints.
- Idempotent
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
fields_to_updateobjectrequired- Fields to change, nested by category. Example: {"firstName": "Jacky", "home": {"mobilePhone": "63635356"}}
hibob_task_completeMark a task as complete.WriteComplete Task
Mark a task as complete. Returns an empty response on success. Use hibob_task_complete with a task ID from hibob_tasks_list or hibob_employee_tasks_list.
Inputs
task_idstringrequired- Task ID. Example: 61f3d8a2b1c4e5f6a7b8c9d0
hibob_timeoff_request_createSubmit a time off request in days for an employee; it follows the policy's approval flow unless an admin skips approval.WriteSubmit Time Off Request
Submit a time off request in days for an employee; it follows the policy's approval flow unless an admin skips approval. Returns the request ID. Use hibob_timeoff_request_create for full or half days. Get policy type names from hibob_timeoff_policy_types_list.
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
end_datestringrequired- Last day (YYYY-MM-DD). Example: 2026-12-24
end_date_portionstringrequired- all_day or morning. Example: all_dayone of
all_daymorningdefaultall_day policy_typestringrequired- Policy type name, such as Holiday or Sick. Example: Holiday
start_datestringrequired- First day (YYYY-MM-DD). Example: 2026-12-22
start_date_portionstringrequired- all_day or afternoon. Example: all_dayone of
all_dayafternoondefaultall_day approverstring- Employee ID of the approver, when the policy lets the requester choose. Example: 3332883884017713239
descriptionstring- Reason for the request. Example: Family holiday
skip_manager_approvalboolean- Admins only: approve the request straight away. Example: false
hibob_timeoff_request_cancelCancel an existing time off request of an employee.DestructiveCancel Time Off Request
Cancel an existing time off request of an employee. Returns an empty response on success. Use hibob_timeoff_request_cancel to withdraw a request.
- Idempotent
Inputs
employee_idstringrequired- Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
request_idintegerrequired- Time off request ID. Example: 7841234
No tools match.