# HiBob

```json
{
  "name": "HiBob",
  "slug": "hibob",
  "url": "https://composio.dev/toolkits/hibob",
  "markdown_url": "https://composio.dev/toolkits/hibob.md",
  "logo_url": "https://logos.composio.dev/api/hibob",
  "categories": [
    "hr & recruiting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-10-27T05:35:39.678Z"
}
```

![HiBob logo](https://logos.composio.dev/api/hibob)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with HiBob MCP or direct API to manage employee data, review attendance, track time off, and support workforce planning through natural language.

## Summary

HiBob is a human resources platform for managing people data, time off, attendance, and workforce planning.
It gives HR teams one place to organize employee information and daily people operations.

## Categories

- hr & recruiting

## Toolkit Details

- Tools: 208

## Images

- Logo: https://logos.composio.dev/api/hibob

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for HiBob.
  - Setup:
    - Configure Api Key credentials for HiBob.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List HiBob employees by department
- Review pending HiBob time off requests
- Summarize HiBob attendance issues this week

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `HIBOB_ARCHIVE_PROJECT` | Archive Project | Archive an attendance project. |
| `HIBOB_ARCHIVE_PROJECT_TASK` | Archive Project Task | Archive a project task. |
| `HIBOB_ARCHIVE_SKILLS` | Archive skills | Bulk-archive API-origin skills by source and externalId locator. |
| `HIBOB_ARCHIVE_TRAINING_CONTENT` | Archive training content (bulk) | Mark one or more LMS training content items as archived. |
| `HIBOB_BULK_CREATE_ATTENDANCE_ENTRIES` | Bulk create attendance entries | Create one or more duration or start-end attendance entries. |
| `HIBOB_BULK_UPDATE_ATTENDANCE_ENTRIES` | Bulk update attendance entries for an employee | Update one or more attendance entries for a specific employee. |
| `HIBOB_CANCEL_POSITION` | Cancel Position | Immediately cancel one workforce-planning position. |
| `HIBOB_CANCEL_TIME_OFF_REQUEST` | Cancel time off request | Cancel an employee's time off request. |
| `HIBOB_CLOCK_IN_EMPLOYEE` | Clock in (create entry) | Create an attendance entry by clocking in an employee. |
| `HIBOB_CLOCK_OUT_EMPLOYEE` | Clock out | Record clock-out for an employee with an open clock-in. |
| `HIBOB_COMPLETE_TASK` | Mark a task as complete | Marks a task as complete. |
| `HIBOB_CREATE_COMPANY_EMPLOYEE` | Create company employee | This endpoint allows you to create a new employee in the system. |
| `HIBOB_CREATE_CUSTOM_TABLE_ENTRY` | Create new custom table entry | Create an entry in an employee's custom table from column-value pairs. |
| `HIBOB_CREATE_EMPLOYEE_BANK_ACCOUNT` | Create a new bank account entry for a given employee | Create a new bank account entry for a given employee. |
| `HIBOB_CREATE_EMPLOYEE_DEDUCTION` | Create a deduction entry for an employee | Creates a new deduction table entry for the employee. |
| `HIBOB_CREATE_EMPLOYEE_DEPENDENT` | Create a dependent entry for an employee | Creates a new dependent entry for the employee. |
| `HIBOB_CREATE_EMPLOYEE_EMPLOYMENT_HISTORY` | Creates a new employment entry for a given employee | Creates a new employment entry for a given employee. |
| `HIBOB_CREATE_EMPLOYEE_ENTITLEMENT` | Create an entitlement entry for an employee | Creates a new entitlement table entry for the employee. |
| `HIBOB_CREATE_EMPLOYEE_EQUITY_GRANT` | Creates a new equity grant for a given employee | Creates a new equity grant for a given employee. |
| `HIBOB_CREATE_EMPLOYEE_FIELD` | Create a new field | Create a new field. |
| `HIBOB_CREATE_EMPLOYEE_RIGHT_TO_WORK` | Create a right to work entry for an employee | Creates a new right to work entry for the employee. |
| `HIBOB_CREATE_EMPLOYEE_SALARY_HISTORY` | Creates a new salary entry for a given employee | Creates a new salary entry for a given employee. |
| `HIBOB_CREATE_EMPLOYEE_TRAINING_RECORD` | Creates a new training records for a given employee | Create a new training record in the Training table. |
| `HIBOB_CREATE_EMPLOYEE_VARIABLE_PAYMENT` | Creates a new variable payment for a given employee | Creates a new variable pay entry for the employee. |
| `HIBOB_CREATE_EMPLOYEE_WORK_HISTORY` | Create a new work entry for a given employee | Create a new work entry for a given employee. |
| `HIBOB_CREATE_GOALS` | Create goals | Creates up to 25 goals in HiBob. |
| `HIBOB_CREATE_INTEGRATION` | Create integration | Create an LMS provider integration in Bob. |
| `HIBOB_CREATE_KEY_RESULTS` | Create key results | Creates up to 25 key results for an existing goal. |
| `HIBOB_CREATE_NAMED_LIST_ITEM` | Add a new item to an existing list | Add a new item to an existing list. |
| `HIBOB_CREATE_POSITION` | Create Position | Create workforce-planning positions with their required opening and optional budget. |
| `HIBOB_CREATE_POSITION_BUDGET` | Create Position Budget | Create a budget for a workforce-planning position. |
| `HIBOB_CREATE_POSITION_OPENING` | Create Position Opening | Create one or more openings for a workforce-planning position. |
| `HIBOB_CREATE_PROJECTS` | Create Project(s) | Create one or more attendance projects. |
| `HIBOB_CREATE_PROJECT_TASKS` | Create Project Task(s) | Create one or more attendance project tasks. |
| `HIBOB_CREATE_SKILLS` | Create skills | Bulk-create API-origin skills with per-item results. |
| `HIBOB_CREATE_TIME_OFF_BALANCE_ADJUSTMENT` | Create time off balance adjustment | Add a manual balance or time-used adjustment for an employee. |
| `HIBOB_CREATE_TIME_OFF_REASON_CODES` | Create time off reason codes | Create reason codes for a configured time off policy type. |
| `HIBOB_CREATE_TIME_OFF_REQUEST` | Create time off request | Submit a time off request for an employee using one documented duration shape. |
| `HIBOB_CREATE_TRAINING_CONTENT` | Create training content (bulk insert) | Create up to 500 training content items for an LMS integration. |
| `HIBOB_DELETE_ATTENDANCE_ENTRY` | Delete an attendance entry | Permanently delete an attendance entry by ID. |
| `HIBOB_DELETE_CONFIDENTIAL_DOCUMENT` | Delete a Document from a Confidential Folder | Delete a document from an employee's confidential folder. |
| `HIBOB_DELETE_CUSTOM_FOLDER_DOCUMENT` | Delete a Document from a Custom Folder | Delete a document from an employee's custom folder. |
| `HIBOB_DELETE_CUSTOM_TABLE_ENTRY` | Delete custom table entry | Delete custom table entry. |
| `HIBOB_DELETE_EMPLOYEE_BANK_ACCOUNT` | Deletes a bank account entry from a given employee's bank accounts table | Deletes a bank account entry from a given employee's bank accounts table. |
| `HIBOB_DELETE_EMPLOYEE_DEDUCTION` | Delete a deduction entry for an employee | Deletes a deduction entry for the given employee. |
| `HIBOB_DELETE_EMPLOYEE_DEPENDENT` | Delete a dependent entry for an employee | Deletes a dependent entry for the given employee. |
| `HIBOB_DELETE_EMPLOYEE_EMPLOYMENT_HISTORY` | Deletes an employment entry from a given employee's employment history | Deletes an employment entry from a given employee's employment history. |
| `HIBOB_DELETE_EMPLOYEE_ENTITLEMENT` | Delete an entitlement entry for an employee | Deletes an entitlement entry for the given employee. |
| `HIBOB_DELETE_EMPLOYEE_EQUITY_GRANT` | Deletes an equity grant for an employee | Deletes an equity grant for an employee. |
| `HIBOB_DELETE_EMPLOYEE_FIELD` | Delete an existing field | Delete an existing field. |
| `HIBOB_DELETE_EMPLOYEE_RIGHT_TO_WORK` | Delete a right to work entry for an employee | Deletes a right to work entry for the given employee. |
| `HIBOB_DELETE_EMPLOYEE_SALARY_HISTORY` | Deletes a salary entry from the employee's list | Deletes a salary entry from the employee's list. |
| `HIBOB_DELETE_EMPLOYEE_TRAINING_RECORD` | Deletes any training records for an employee | Deletes any training records for an employee. |
| `HIBOB_DELETE_EMPLOYEE_VARIABLE_PAYMENT` | Deletes a variable payment record for an employee | Deletes a variable pay entry for the given employee. |
| `HIBOB_DELETE_EMPLOYEE_WORK_HISTORY` | Deletes a work entry from a given employee's work history | Deletes a work entry from a given employee's work history. |
| `HIBOB_DELETE_GOAL` | Delete goal | Permanently deletes a goal by ID. |
| `HIBOB_DELETE_KEY_RESULT` | Delete key result | Permanently deletes a key result from a goal. |
| `HIBOB_DELETE_LMS_INTEGRATION` | Delete LMS integration | Delete an LMS provider integration from Bob. |
| `HIBOB_DELETE_NAMED_LIST_ITEM` | Delete an item from an existing list | Delete an item from an existing list. |
| `HIBOB_DELETE_POSITION_OPENING` | Delete Position Opening | Delete an opening from a workforce-planning position. |
| `HIBOB_DELETE_SHARED_DOCUMENT` | Delete a Document from a Shared Folder | Delete a document from an employee's shared folder. |
| `HIBOB_DOWNLOAD_REPORT_BY_ID` | Download the report by ID | Returns a report data file in the specified format. |
| `HIBOB_DOWNLOAD_REPORT_BY_NAME` | Download a report by the report name | Downloads a report generated by the asynchronous report endpoint. A 204 response means the file is not ready and is returned as an execution failure so no empty file is emitted. |
| `HIBOB_GET_AVATAR_BY_EMAIL` | Read avatar URL for an employee email | Returns the employee's avatar image URL without fetching the image. |
| `HIBOB_GET_AVATAR_BY_EMPLOYEE_ID` | Read avatar URL for an employee ID | Returns the employee's avatar image URL without fetching the image. |
| `HIBOB_GET_CUSTOM_TABLE_METADATA` | Read metadata for specific custom table | Read metadata for specific custom table. |
| `HIBOB_GET_DOCUMENT_FOLDERS_METADATA` | Get document folders metadata | List Bob document folders and their identifiers. |
| `HIBOB_GET_EMPLOYEE_TIME_OFF_BALANCE` | Get employee time off balance | Retrieve an employee's balance for a policy type at a point in time. |
| `HIBOB_GET_EMPLOYER_METADATA` | Get employer metadata | Returns the field catalog for the `employer` object — the set of fields a client can read, with their types, validations, and status. |
| `HIBOB_GET_GOAL_CYCLE_METADATA` | Get goal cycle metadata | Returns metadata describing the fields available on goal cycles. |
| `HIBOB_GET_GOALS_METADATA` | Get goals metadata | Returns metadata describing the fields available on goals. |
| `HIBOB_GET_GOAL_TYPE_METADATA` | Get goal type metadata | Returns metadata describing the fields available on goal types. |
| `HIBOB_GET_JOB_AD` | Get job ad | Returns details of a job ad promoted on the Bob careers page. |
| `HIBOB_GET_JOB_FAMILY_GROUP_METADATA` | Get job family group metadata | Returns metadata describing job-family-group fields. |
| `HIBOB_GET_JOB_FAMILY_METADATA` | Get job family metadata | Returns metadata describing job-family fields. |
| `HIBOB_GET_JOB_PROFILES_METADATA` | Get job profiles metadata | Returns metadata describing job-profile fields. |
| `HIBOB_GET_JOB_ROLE_METADATA` | Get job role metadata | Returns metadata describing job-role fields. |
| `HIBOB_GET_KEY_RESULTS_METADATA` | Get key results metadata | Returns metadata describing the fields available on key results. |
| `HIBOB_GET_NAMED_LIST` | Get a specific company list by name | Get a specific company list by name. |
| `HIBOB_GET_PERSON` | Read company employee fields by employee ID | Single-employee read endpoint (not bulk search): returns field data for one employee identified by backend ID or email in the path in a single response. |
| `HIBOB_GET_POSITION_BUDGET_METADATA` | Get Position Budget Metadata | Get the field metadata for workforce-planning position budgets. |
| `HIBOB_GET_POSITION_METADATA` | Get Position Metadata | Get the field metadata for workforce-planning positions. |
| `HIBOB_GET_POSITION_OPENING_METADATA` | Get Position Opening Metadata | Get the field metadata for workforce-planning position openings. |
| `HIBOB_GET_PROJECT_CLIENT_METADATA` | Get Project Client Metadata | Get metadata describing available project client fields. |
| `HIBOB_GET_PROJECT_METADATA` | Get Project Metadata | Get metadata describing available attendance project fields. |
| `HIBOB_GET_PROJECT_TASK_METADATA` | Get Project Task Metadata | Get metadata describing available project task fields. |
| `HIBOB_GET_TIME_OFF_POLICY_DETAILS` | Get time off policy details | Retrieve details of a named time off policy. |
| `HIBOB_GET_TIME_OFF_POLICY_TYPE` | Get time off policy type | Retrieve a configured time off policy type. |
| `HIBOB_GET_TIME_OFF_REQUEST` | Get time off request | Retrieve one employee time off request by ID. |
| `HIBOB_GET_WORK_LOCATION_METADATA` | Get work location metadata | Returns the field catalog for the `workLocation` object — the set of fields a client can read, with their types, validations, and status. |
| `HIBOB_IMPORT_ATTENDANCE_DATA` | Import attendance data | Import employee clock-in and clock-out events. |
| `HIBOB_INVITE_EMPLOYEE` | Invite an employee with a welcome wizard ID | Invite an employee to HiBob using an onboarding welcome wizard. |
| `HIBOB_LIST_COMPANY_JOB_PROFILES` | List company job profiles | Searches company job profiles and returns one page of matching profiles. |
| `HIBOB_LIST_COMPANY_LISTS` | Get all company lists | Get all company lists. |
| `HIBOB_LIST_COMPANY_REPORTS` | Read company reports | Returns a list of all company reports with their details. |
| `HIBOB_LIST_CUSTOM_TABLE_ENTRIES` | Read all entries of the given custom table | Read all entries of the given custom table. |
| `HIBOB_LIST_CUSTOM_TABLES_METADATA` | Read metadata of custom tables defined | Read metadata of custom tables defined. |
| `HIBOB_LIST_EMPLOYEE_BANK_ACCOUNTS` | List employee's bank accounts | Returns a list of the bank accounts table entries for a given employee. |
| `HIBOB_LIST_EMPLOYEE_DEDUCTION_RECORDS` | List deduction entries for a list of employees | Returns deduction table entries for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_DEPENDENTS_RECORDS` | List dependents for a list of employees | Returns dependent entries for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_DOCUMENTS` | Download list of documents of an employee | Return an employee's documents with downloadable file references. |
| `HIBOB_LIST_EMPLOYEE_EMPLOYMENT_HISTORIES` | List employee's employment history | Returns a list of employment history entries for a given employee. |
| `HIBOB_LIST_EMPLOYEE_EMPLOYMENT_RECORDS` | List employment history for a list of employees | Returns a list of historical employment entries from the employment table for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_ENTITLEMENT_RECORDS` | List entitlement entries for a list of employees | Returns entitlement table entries for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_EQUITIES_RECORDS` | List equity grants for a list of employees | Returns equity table entries for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_EQUITY_GRANTS` | List the employee's equity grants | Returns a list of equity grants for a given employee. |
| `HIBOB_LIST_EMPLOYEE_FIELDS` | Get all employee fields | This endpoint retrieves only metadata about the employee fields and includes all employee fields. |
| `HIBOB_LIST_EMPLOYEE_LIFECYCLE_HISTORIES` | List employee's lifecycle status history | Returns a list of historical lifecycle entries from the lifecycle table for an employee. |
| `HIBOB_LIST_EMPLOYEE_LIFECYCLE_RECORDS` | List the lifecycle history for a list of employees | Returns a list of historical lifecycle entries from the lifecycle table for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_PUBLIC_PROFILES` | Read the public profile section of all active employees | Returns a predefined list of fields for all active employees the service user can access. |
| `HIBOB_LIST_EMPLOYEE_RIGHT_TO_WORK_RECORDS` | List right to work entries for a list of employees | Returns right to work entries for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_SALARIES_RECORDS` | List payroll history (salaries) for a list of employees | Returns a list of historical salary entries from the payroll table for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_SALARY_HISTORIES` | List employee's salary history | Returns a list of historical salary entries from the salary table in the payroll section for an employee. |
| `HIBOB_LIST_EMPLOYEE_TASKS` | Read tasks of a specific employee | Returns tasks for a specific employee, optionally filtered by status. |
| `HIBOB_LIST_EMPLOYEE_TRAINING_RECORDS` | List the employee's training records | Returns a list of training entries from the employee's Training table, for a given employee. |
| `HIBOB_LIST_EMPLOYEE_VARIABLE_PAYMENTS` | List employee's variable payments | Returns a list of variable payments for a given employee. |
| `HIBOB_LIST_EMPLOYEE_VARIABLE_RECORDS` | List variable pay entries for a list of employees | Returns variable pay table entries for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_EMPLOYEE_WORK_HISTORIES` | List employee's work history | Returns a list of historical work entries from the work table for an employee. |
| `HIBOB_LIST_EMPLOYEE_WORK_RECORDS` | List work history for a list of employees | Returns a list of historical work entries from the work table for all employees or a specific list of employees. Returns one page and a continuation cursor when available. |
| `HIBOB_LIST_JOB_FAMILIES` | List job families | Returns one page of job families from the company job catalog. |
| `HIBOB_LIST_JOB_FAMILY_GROUPS` | List job family groups | Returns one page of job-family groups from the company job catalog. |
| `HIBOB_LIST_JOB_ROLES` | List job roles | Returns one page of job roles from the company job catalog. |
| `HIBOB_LIST_ONBOARDING_WIZARDS` | Get a summary of all onboarding wizards | List onboarding welcome wizards and their IDs for inviting employees. |
| `HIBOB_LIST_OPEN_TASKS` | List open tasks | Returns up to 5,000 open company tasks ordered by task ID. HiBob imposes this hard limit and provides no pagination, so companies with more than 5,000 open tasks receive an incomplete set. |
| `HIBOB_LIST_PAYROLL_TABLES_HISTORY` | Read payroll tables history | List legacy payroll-table history, optionally filtered by department and inactive employees; this provider endpoint is planned for deprecation. |
| `HIBOB_LIST_PEOPLE_OUT_OF_OFFICE` | List people out of office | List people with time off requests in an inclusive date range. |
| `HIBOB_LIST_PEOPLE_OUT_TODAY` | List people out today | List people who are out on a selected date. |
| `HIBOB_LIST_PROFICIENCY_LEVELS` | List proficiency levels | Lists the company's proficiency levels referenced by skill create and update operations. |
| `HIBOB_LIST_TIME_OFF_POLICY_NAMES` | List time off policy names | List policy names belonging to a time off policy type. |
| `HIBOB_LIST_TIME_OFF_POLICY_TYPES` | List time off policy types | List configured time off policy type names. |
| `HIBOB_LIST_TIME_OFF_REASON_CODES` | List time off reason codes | List request reason codes configured for a policy type. |
| `HIBOB_LIST_TIME_OFF_REQUEST_CHANGES` | List time off request changes | List time off requests created, canceled, deleted, or pending since a point in time. |
| `HIBOB_RESTORE_PROJECT` | Restore Project | Restore an archived attendance project. |
| `HIBOB_RESTORE_PROJECT_TASK` | Restore Project Task | Restore an archived project task. |
| `HIBOB_REVOKE_EMPLOYEE_ACCESS` | Revoke access to Bob for an employee | Revoke an employee's access to HiBob without deleting the employee record. |
| `HIBOB_SCHEDULE_POSITION_CANCELLATION` | Schedule Position Cancellation | Cancel multiple positions immediately or on a specified date. |
| `HIBOB_SEARCH_ACTUAL_PAYMENTS` | Search for actual payments | This endpoint allows you to search for actual payments based on various filters. Returns one page and a continuation cursor when available. |
| `HIBOB_SEARCH_APPLICATION_FORM_ANSWERS` | Search application form answers | Searches application form answer records using filters and returns one page of results. |
| `HIBOB_SEARCH_APPLICATIONS` | Search applications | Searches applications using filters and returns one page of results. |
| `HIBOB_SEARCH_ATTENDANCE_ENTRIES` | Fetch attendance entries | Retrieve one page of attendance entries for employees and dates. |
| `HIBOB_SEARCH_ATTENDANCE_SUMMARIES` | Fetch attendance summaries | Retrieve one page of attendance summaries by employee and date range. |
| `HIBOB_SEARCH_CALENDAR_EVENTS` | Search calendar events | Search holiday and company-closure calendar events for an inclusive date range. |
| `HIBOB_SEARCH_CANDIDATE_EDUCATIONS` | Search candidate educations | Searches candidate education records and returns one page. |
| `HIBOB_SEARCH_CANDIDATE_EXPERIENCES` | Search candidate experiences | Searches candidate work experience records and returns one page. |
| `HIBOB_SEARCH_CANDIDATE_LANGUAGES` | Search candidate languages | Searches candidate language records and returns one page. |
| `HIBOB_SEARCH_CANDIDATE_PROFESSIONAL_ASSOCIATIONS_MEMBERSHIPS` | Search candidate professional association memberships | Searches candidate professional association membership records and returns one page. |
| `HIBOB_SEARCH_CANDIDATE_QUALIFICATIONS_LICENSES` | Search candidate qualifications and licenses | Searches candidate qualification and license records and returns one page. |
| `HIBOB_SEARCH_CANDIDATES` | Search candidates | Searches candidates using filters and returns one page of results. |
| `HIBOB_SEARCH_CANDIDATE_SKILLS` | Search candidate skills | Searches candidate skill records and returns one page. |
| `HIBOB_SEARCH_CANDIDATE_VOLUNTEER_EXPERIENCES` | Search candidate volunteer experiences | Searches candidate volunteer experience records and returns one page. |
| `HIBOB_SEARCH_DAILY_ATTENDANCE_BREAKDOWN` | Fetch daily attendance breakdown | Retrieve one page of daily attendance breakdown data for employees. |
| `HIBOB_SEARCH_EMPLOYEE_CALENDARS` | Search employee calendars | Resolve holiday calendars for employees and return one page of results. |
| `HIBOB_SEARCH_EMPLOYERS` | Search employers | Searches employers in the caller's company. Returns one page and a continuation cursor when available. |
| `HIBOB_SEARCH_EVALUATIONS` | Search evaluations | Searches evaluation records and returns one page. |
| `HIBOB_SEARCH_EVALUATION_SCORECARD_TEMPLATES` | Search evaluation scorecard templates | Searches evaluation scorecard templates and returns one page. |
| `HIBOB_SEARCH_GOAL_CYCLES` | Search goal cycles | Searches goal cycles and returns one page of matching records. |
| `HIBOB_SEARCH_GOALS` | Search goals | Searches goals and returns one page of matching records. |
| `HIBOB_SEARCH_GOAL_TYPES` | Search goal types | Searches goal types and returns one page of matching records. |
| `HIBOB_SEARCH_INTERVIEWS` | Search interviews | Searches interview records and returns one page. |
| `HIBOB_SEARCH_JOB_ADS` | Search job ads | Returns active job ads promoted on the Bob career page. |
| `HIBOB_SEARCH_JOB_OPENINGS` | Search job openings | Searches job openings using filters and returns one page. |
| `HIBOB_SEARCH_KEY_RESULTS` | Search key results | Searches key results for a goal and returns one page. |
| `HIBOB_SEARCH_OFFERS` | Search offers | Searches offer records and returns one page. |
| `HIBOB_SEARCH_PEOPLE` | Search for employees | Search employee fields for many employees in one call. |
| `HIBOB_SEARCH_POSITION_BUDGETS` | Search Position Budgets | Return one page of workforce-planning position budgets. |
| `HIBOB_SEARCH_POSITION_OPENINGS` | Search Position Openings | Return one page of workforce-planning position openings. |
| `HIBOB_SEARCH_POSITIONS` | Search Positions | Search workforce-planning positions using documented field filters. |
| `HIBOB_SEARCH_PROJECT_CLIENTS` | Search Project Clients | Search project clients and return one page of results. |
| `HIBOB_SEARCH_PROJECTS` | Search Projects | Search attendance projects and return one page of results. |
| `HIBOB_SEARCH_PROJECT_TASKS` | Search Project Tasks | Search attendance project tasks and return one page of results. |
| `HIBOB_SEARCH_SKILLS` | Search skills | Searches API-origin skills with field projection, filters, and one-page cursor pagination. |
| `HIBOB_SEARCH_WORK_LOCATIONS` | Search work locations | Searches the work locations of a single employer, identified by the path parameter `{employerId}`. Returns one page and a continuation cursor when available. |
| `HIBOB_SET_EMPLOYEE_START_DATE` | Set or update an employee's start date | Set or change an employee's employment start date, with an optional reason. |
| `HIBOB_START_REPORT_GENERATION` | Get the report download URL for polling | Asynchronously generates a report. HiBob returns 202 while generation starts and 200 with the generated report URL in the Location response header. |
| `HIBOB_SUBMIT_X_API_STATEMENT` | Submit xAPI statement | Submit one xAPI statement to record learner progress for a course. |
| `HIBOB_TERMINATE_COMPANY_EMPLOYEE` | Terminate company employee | This changes the employee’s status to Terminated according to specified termination date. |
| `HIBOB_UPDATE_COMPANY_EMPLOYEE` | Update company employee | This endpoint allows you to update specific fields in an employee's record in Bob. |
| `HIBOB_UPDATE_CUSTOM_TABLE_ENTRY` | Update custom table entry | Update an employee's custom-table entry from column-value pairs. |
| `HIBOB_UPDATE_EMPLOYEE_AVATAR` | Upload employee's avatar by image url | Upload an employee's Avatar by providing a URL to the image to upload. |
| `HIBOB_UPDATE_EMPLOYEE_BANK_ACCOUNT` | Update a bank account entry in the employee's bank accounts table | This endpoint updates an entry in the employee’s Bank accounts table. |
| `HIBOB_UPDATE_EMPLOYEE_DEDUCTION` | Update a deduction entry for an employee | Updates an existing deduction entry for the given employee. |
| `HIBOB_UPDATE_EMPLOYEE_DEPENDENT` | Update a dependent entry for an employee | Updates an existing dependent entry for the given employee. |
| `HIBOB_UPDATE_EMPLOYEE_EMAIL` | Update an employee's email address | Change an employee's email address. |
| `HIBOB_UPDATE_EMPLOYEE_EMPLOYMENT_HISTORY` | Update an employment entry from a given employee's employment history | This endpoint updates an entry in the employee’s employment history table. |
| `HIBOB_UPDATE_EMPLOYEE_ENTITLEMENT` | Update an entitlement entry for an employee | Updates an existing entitlement entry for the given employee. |
| `HIBOB_UPDATE_EMPLOYEE_EQUITY_GRANT` | Updates an equity grant for an employee | This endpoint updates an entry in the employee’s equity table. |
| `HIBOB_UPDATE_EMPLOYEE_FIELD` | Update an existing field | Update an existing field. |
| `HIBOB_UPDATE_EMPLOYEE_RIGHT_TO_WORK` | Update a right to work entry for an employee | Updates an existing right to work entry for the given employee. |
| `HIBOB_UPDATE_EMPLOYEE_VARIABLE_PAYMENT` | Update a variable payment for an employee | Updates an existing variable pay entry for the given employee. |
| `HIBOB_UPDATE_EMPLOYEE_WORK_HISTORY` | Update a work entry in the employee's work history table | This endpoint updates an entry in the employee’s work history table. |
| `HIBOB_UPDATE_GOAL` | Update goal | Updates details of an existing goal. |
| `HIBOB_UPDATE_GOAL_STATUS` | Update goal status | Updates the status of an existing goal and optionally records a comment. |
| `HIBOB_UPDATE_KEY_RESULTS_DETAILS` | Update key results details | Updates details of one or more key results on a goal. |
| `HIBOB_UPDATE_KEY_RESULTS_PROGRESS` | Update key results progress | Records progress values and optional check-in notes for key results. |
| `HIBOB_UPDATE_NAMED_LIST_ITEM` | Update an existing item from a list | Update an existing item from a list. |
| `HIBOB_UPDATE_POSITION` | Update Position | Update the mutable fields of one workforce-planning position. |
| `HIBOB_UPDATE_POSITION_BUDGET` | Update Position Budget | Update a budget attached to a workforce-planning position. |
| `HIBOB_UPDATE_POSITION_OPENING` | Update Position Opening | Update an opening attached to a workforce-planning position. |
| `HIBOB_UPDATE_PROJECT` | Update Project | Update an attendance project's fields and employee audience. |
| `HIBOB_UPDATE_PROJECT_TASK` | Update Project Task | Update the name and billable state of a project task. |
| `HIBOB_UPDATE_SKILLS` | Update skills | Bulk-update API-origin skills resolved by source and externalId locator. |
| `HIBOB_UPDATE_TRAINING_CONTENT` | Update training content (bulk patch) | Update one or more training content items for an LMS integration. |
| `HIBOB_UPLOAD_CONFIDENTIAL_DOCUMENT` | Upload File to a Confidential Folder | Upload a file directly into an employee's confidential folder. |
| `HIBOB_UPLOAD_CONFIDENTIAL_DOCUMENT_FROM_URL` | Upload file from a URL to a Confidential Folder | Upload a document from a URL into an employee's confidential folder. |
| `HIBOB_UPLOAD_CUSTOM_FOLDER_DOCUMENT` | Upload File to a Custom Folder | Upload a file directly into an employee's custom folder. |
| `HIBOB_UPLOAD_CUSTOM_FOLDER_DOCUMENT_FROM_URL` | Upload File from a URL to a Custom Folder | Upload a document from a URL into an employee's custom folder. |
| `HIBOB_UPLOAD_SHARED_DOCUMENT` | Upload file to a Shared Folder | Upload a file directly into an employee's shared folder. |
| `HIBOB_UPLOAD_SHARED_DOCUMENT_FROM_URL` | Upload file from a URL to a Shared Folder | Upload a document from a URL into an employee's shared folder. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to HiBob
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["hibob"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["hibob"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run HiBob tools with your agent

Send a request, execute the HiBob tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "List all employees in HiBob and group them by department."}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all employees in HiBob and group them by department." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to HiBob and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["hibob"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["hibob"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a HiBob request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to HiBob tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("List all employees in HiBob and group them by department.")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all employees in HiBob and group them by department.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native HiBob Integration

- Supports both HiBob MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying employee, attendance, and time off data

### 2. Secure API Key Auth

- Connect HiBob with your own API key credentials
- Keep credentials out of prompts, application code, and agent conversations
- Manage access centrally and rotate keys without changing agent workflows

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Clear schemas help agents choose the right HiBob action and provide the required fields
- Comprehensive execution logs show what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC helps control which agents and users can access HiBob
- Scoped, least privilege access protects employee and workforce data
- Full audit trails support HR reviews, security checks, and compliance workflows

## Use HiBob with any AI Agent Framework

Choose a framework you want to connect HiBob with:

- [ChatGPT](https://composio.dev/toolkits/hibob/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/hibob/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/hibob/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/hibob/framework/atomic-agent)

## Related Toolkits

- [Ashby](https://composio.dev/toolkits/ashby) - Ashby is an applicant tracking system that handles job postings, candidate management, and hiring analytics.
- [7shifts](https://composio.dev/toolkits/7shifts) - 7shifts is a restaurant team management platform for scheduling, time clocks, payroll, and team communication. It helps operators keep labor, shifts, and staff workflows organized in one place.
- [AI Ark](https://composio.dev/toolkits/ai_ark) - AI Ark is a people and company intelligence platform with search, enrichment, and recruiting APIs. It helps teams find accurate contact data and discover hiring insights faster.
- [Async interview](https://composio.dev/toolkits/async_interview) - Async interview is an on-demand video interview platform for streamlined hiring. Candidates record responses on their schedule, so employers can review anytime.
- [Bamboohr](https://composio.dev/toolkits/bamboohr) - BambooHR is a cloud-based HR management platform for small and mid-sized businesses. It streamlines employee data, HR workflows, and reporting in one easy interface.
- [Breathe HR](https://composio.dev/toolkits/breathehr) - Breathe HR is cloud-based HR software for SMEs to manage employee data, absences, and performance. It simplifies HR admin, making it easy to keep employee records accurate and up to date.
- [Breezy Hr](https://composio.dev/toolkits/breezy_hr) - Breezy HR is a recruiting and applicant tracking platform for managing jobs, candidates, pipelines, and hiring teams. It helps teams move faster from job posting to offer without losing track of applicants.
- [Connecteam](https://composio.dev/toolkits/connecteam) - Connecteam is a workforce management platform for deskless teams, streamlining operations, HR, and team communication. It helps businesses save time by automating scheduling, time tracking, and staff engagement tasks.
- [ContactOut](https://composio.dev/toolkits/contactout) - ContactOut is a professional profile enrichment and contact discovery API. Find and verify email addresses to power recruiting, sales, and outreach.
- [Coresignal](https://composio.dev/toolkits/coresignal) - Coresignal is a real-time public web data platform for employee, company, and professional profile intelligence. It helps teams access fresh workforce data for research, recruiting, sales, and market analysis.
- [Deputy](https://composio.dev/toolkits/deputy) - Deputy is a workforce management platform for scheduling, employees, timesheets, leave, and workplace locations. It helps teams simplify staff planning, time tracking, and daily workforce operations.
- [Dice MCP](https://composio.dev/toolkits/dice_mcp) - Dice MCP is an MCP server for searching Dice's tech-job database by role, company, location, and employment type. It helps agents find relevant tech roles fast with conversational filters.
- [Greenhouse](https://composio.dev/toolkits/greenhouse) - Greenhouse is applicant tracking and recruiting software for managing jobs, candidates, interviews, and hiring workflows. It helps recruiting teams move faster with structured pipelines, collaboration tools, and hiring data in one place.
- [Gusto](https://composio.dev/toolkits/gusto) - Gusto is a payroll, benefits, and HR platform for small and medium businesses. It helps teams run payroll, manage people, and stay compliant with less busywork.
- [Hireflix](https://composio.dev/toolkits/hireflix) - Hireflix is a one-way video interview platform for hiring teams. It helps teams manage positions, candidate interviews, templates, and branded hiring workflows in one place.
- [HR Partner](https://composio.dev/toolkits/hr_partner) - HR Partner is a human resources platform for managing employee records, leave, recruitment, performance, timesheets, and expenses. Use it to centralize HR workflows, automate manual HR tasks, and keep employee data organized.
- [Job Search (Rapid API)](https://composio.dev/toolkits/job_search) - Job Search (Rapid API) is a unified service that searches approved job-listing sources via RapidAPI hosts. Use it to aggregate and query listings across providers with a single API.
- [Lever](https://composio.dev/toolkits/lever) - Lever is an applicant tracking system that blends sourcing, CRM, and analytics for recruiting. It helps companies scale hiring with collaborative workflows and actionable insights.
- [Personio](https://composio.dev/toolkits/personio) - Personio is an HR platform for managing employee records, attendance, absences, projects, and documents. It centralizes HR data and streamlines workforce administration for teams and HR leaders.
- [Remote retrieval](https://composio.dev/toolkits/remote_retrieval) - Remote retrieval is a logistics automation tool for managing laptop and monitor returns. It streamlines return tracking, saving time and hassle for IT and ops teams.

## Frequently Asked Questions

### Do I need my own developer credentials to use HiBob with Composio?

Yes, HiBob requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)