> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# HiBob

**Authentication:** service user. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* List employees with anniversaries this month so I can send recognition notes.
* Find every employee whose probation period ends in the next 30 days.
* Pull headcount by department for the end of last quarter.

## Available Tools

#### list\_employee\_documents

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\_from\_url

Upload document to HiBob employee folder from URL. Specify folder\_type ('shared' or 'confidential'). Optionally add tags. Returns uploaded document ID.

#### delete\_document

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\_folder\_metadata

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

#### search\_employees

Search HiBob employees.

#### get\_employee

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\_employee

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\_employee

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\_employee

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.

#### uninvite\_employee

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

#### list\_employee\_fields

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\_named\_list

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

#### create\_named\_list\_item

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\_goals

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\_goal\_metadata

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\_company\_employee\_fields

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\_reports

List all HiBob company reports. Returns paginated report IDs, names, descriptions, and categories. Use report ID with download\_report or download\_report\_async.

#### download\_report

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\_report\_async

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\_tasks

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\_employee\_tasks

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.

#### complete\_task

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\_time\_off\_request

Submit HiBob time off request.

#### get\_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\_time\_off\_request

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\_time\_off\_balance

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\_time\_off\_balance

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\_policy\_types

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\_policies

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

#### get\_whos\_out

Get HiBob who's out calendar for date range.

#### get\_out\_today

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

#### list\_request\_changes

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.