> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to HiBob

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.

**Authentication:** Service User
**Categories:** Productivity, Collaboration
**Tools:** 22: 17 read, 4 write, 1 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=HIBOB)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'hibob_employee_employment_history_list',
  toolInput: {
    employee_id: '<employee_id>',
  },
  connector: 'hibob',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="hibob_employee_employment_history_list",
    tool_input={
        "employee_id": "<employee_id>",
    },
    connection_name="hibob",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `hibob_employee_employment_history_list`

List Employee Employment History · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238

Example input: `{"employee_id":"<employee_id>"}`

### `hibob_employee_get`

Get Employee · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `fields` (`array`, optional): 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_readable` (`string`, optional): REPLACE returns display values instead of IDs for list fields; APPEND returns both. Example: REPLACE. One of: `REPLACE`, `APPEND`.

Example input: `{"employee_id":"<employee_id>"}`

### `hibob_employee_lifecycle_list`

List Employee Lifecycle History · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238

Example input: `{"employee_id":"<employee_id>"}`

### `hibob_employee_tasks_list`

List Employee Tasks · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `task_status` (`string`, optional): open or closed. Example: open. One of: `open`, `closed`.

Example input: `{"employee_id":"<employee_id>"}`

### `hibob_employee_work_history_list`

List Employee Work History · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `include_archived` (`boolean`, optional): Include archived columns. Example: false

Example input: `{"employee_id":"<employee_id>"}`

### `hibob_named_list_get`

Get Company List · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_name` (`string`, required): List name, such as department, site or title. Example: department
- `include_archived` (`boolean`, optional): Include archived items. Example: false

Example input: `{"list_name":"<list_name>"}`

### `hibob_named_lists_list`

List Company Lists · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `include_archived` (`boolean`, optional): Include archived items. Example: false

Example input: `{}`

### `hibob_people_fields_list`

List Employee Fields · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hibob_people_search`

Search Employees · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `fields` (`array`, optional): 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"]
- `filters` (`array`, optional): At most one filter, on root.id or root.email with operator equals. Example: [{"fieldPath": "root.email", "operator": "equals", "values": ["jane@example.com"]}]
- `human_readable` (`string`, optional): REPLACE returns display values instead of IDs for list fields; APPEND returns both. Example: REPLACE. One of: `REPLACE`, `APPEND`.
- `show_inactive` (`boolean`, optional): Include inactive (former) employees. Example: false

Example input: `{}`

### `hibob_profiles_list`

List Employee Profiles · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hibob_tasks_list`

List Open Tasks · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hibob_timeoff_balance_get`

Get Time Off Balance · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, required): Balance as of this date (YYYY-MM-DD). Example: 2026-12-31
- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `policy_type` (`string`, required): Policy type name. Example: Holiday

Example input: `{"date":"<date>","employee_id":"<employee_id>","policy_type":"<policy_type>"}`

### `hibob_timeoff_out_today_list`

List Out Today · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `include_hourly` (`boolean`, optional): Include hourly requests. Example: false
- `site_id` (`integer`, optional): Only employees of this site ID. Example: 1234
- `today` (`string`, optional): Date to check (YYYY-MM-DD); defaults to today in UTC. Example: 2026-11-16

Example input: `{}`

### `hibob_timeoff_policy_types_list`

List Time Off Policy Types · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hibob_timeoff_request_get`

Get Time Off Request · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `request_id` (`integer`, required): Time off request ID. Example: 7841234

Example input: `{"employee_id":"<employee_id>","request_id":7841234}`

### `hibob_timeoff_requests_changes_list`

List Time Off Request Changes · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `since` (`string`, required): Start of the range (ISO-8601 date-time, within the last 31 days). Example: 2026-11-01T00:00:00Z
- `include_pending` (`boolean`, optional): Include pending requests. Example: true
- `to` (`string`, optional): End of the range (ISO-8601 date-time). Example: 2026-11-15T23:59:59Z

Example input: `{"since":"<since>"}`

### `hibob_timeoff_whos_out_list`

List Who's Out · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-12-21
- `to` (`string`, required): End date (YYYY-MM-DD). Example: 2026-12-31
- `include_hourly` (`boolean`, optional): Include hourly requests. Example: false
- `include_pending` (`boolean`, optional): Include pending requests. Example: false

Example input: `{"from":"<from>","to":"<to>"}`

### `hibob_employee_create`

Create Employee · Write

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

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Work email, unique in the company. Example: jane.doe@example.com
- `first_name` (`string`, required): First name. Example: Jane
- `site` (`string`, required): Site display name from the site list. Example: New York
- `start_date` (`string`, required): Employment start date (YYYY-MM-DD). Example: 2026-12-01
- `surname` (`string`, required): Surname. Example: Doe
- `department` (`string`, optional): Department from the department list. Example: Engineering
- `title` (`string`, optional): Job title from the title list. Example: Software Engineer

Example input: `{"email":"<email>","first_name":"<first_name>","site":"<site>","start_date":"<start_date>","surname":"<surname>"}`

### `hibob_employee_update`

Update Employee · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `fields_to_update` (`object`, required): Fields to change, nested by category. Example: {"firstName": "Jacky", "home": {"mobilePhone": "63635356"}}

Example input: `{"employee_id":"<employee_id>","fields_to_update":{}}`

### `hibob_task_complete`

Complete Task · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `task_id` (`string`, required): Task ID. Example: 61f3d8a2b1c4e5f6a7b8c9d0

Example input: `{"task_id":"<task_id>"}`

### `hibob_timeoff_request_create`

Submit Time Off Request · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `end_date` (`string`, required): Last day (YYYY-MM-DD). Example: 2026-12-24
- `end_date_portion` (`string`, required): all_day or morning. Example: all_day. One of: `all_day`, `morning`. Default: `all_day`.
- `policy_type` (`string`, required): Policy type name, such as Holiday or Sick. Example: Holiday
- `start_date` (`string`, required): First day (YYYY-MM-DD). Example: 2026-12-22
- `start_date_portion` (`string`, required): all_day or afternoon. Example: all_day. One of: `all_day`, `afternoon`. Default: `all_day`.
- `approver` (`string`, optional): Employee ID of the approver, when the policy lets the requester choose. Example: 3332883884017713239
- `description` (`string`, optional): Reason for the request. Example: Family holiday
- `skip_manager_approval` (`boolean`, optional): Admins only: approve the request straight away. Example: false

Example input: `{"employee_id":"<employee_id>","end_date":"<end_date>","end_date_portion":"all_day","policy_type":"<policy_type>","start_date":"<start_date>","start_date_portion":"all_day"}`

### `hibob_timeoff_request_cancel`

Cancel Time Off Request · Destructive

Cancel an existing time off request of an employee.
Returns an empty response on success.
Use hibob_timeoff_request_cancel to withdraw a request.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): Employee ID (the backend id from hibob_people_search, also in the employee's Bob URL). Example: 3332883884017713238
- `request_id` (`integer`, required): Time off request ID. Example: 7841234

Example input: `{"employee_id":"<employee_id>","request_id":7841234}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
