Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to HiBob

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the HiBob connection

    In AgentKit > Connections, create a HiBob connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • hibob_employee_employment_history_listList an employee's employment history entries (contract type, weekly hours, salary pay type over time).Read-only

    List 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-only

    Get 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-only

    List 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-only

    List 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-only

    List 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-only

    Get 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-only

    List 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-only

    List 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.