list_employees
Retrieve the employee directory from TalentHR. Returns a paginated list of employees with their basic profile, job assignment, and organizational details.
Use this to browse the workforce, find specific employees, or get an overview of the organization.
update_employee
Update an existing employee's profile data in TalentHR. Supports updating personal info, contact details, address, emergency contact, social media links, identification documents, and other profile fields.
Only provide the fields you want to change. If firstName, lastName, or email is omitted, this tool first reads the employee profile and resubmits those existing required values. The update fails if that profile cannot supply them.
list_organizational_structure
Retrieve organizational structure data from TalentHR including departments, divisions, job titles, locations, and employment statuses.
Select which types to include in the response. Useful for discovering available IDs when creating or updating employees.
create_department
Create a new department in TalentHR. Departments are organizational units used to group employees and structure the company hierarchy.
create_job_title
Create a new job title in TalentHR. Job titles define the roles available in the organization and can be assigned to employees.
create_location
Create a new work location in TalentHR. Provide name, address, and isRemote; TalentHR requires all three. Locations can be assigned to employees.
respond_time_off_request
Approve or reject an employee's time off request in TalentHR. Requires the employee ID, the specific time off request ID, and whether to accept or reject it.
create_division
Create a new division in TalentHR. Divisions represent major organizational segments such as regions or business units.
list_job_applications
List job applications (ATS applicants) from TalentHR. Optionally filter by a specific job position.
Use this to review incoming applications for open roles.
hire_employee
Hire a new employee and register them in the TalentHR system. Creates the employee record with their personal details, job assignment, compensation, and optionally triggers the onboarding process.
Use this to onboard new hires into the organization with their department, division, job title, location, and pay details.
list_time_off_requests
List time off requests for a specific employee in TalentHR. Returns the requests with their type, dates, and current status.
Use this to review pending requests before approving or rejecting them.
list_job_positions
List TalentHR job positions, including position IDs and titles, published state, and application pipeline details returned by TalentHR. Use the IDs to filter list_job_applications.
get_time_off_budgets
Get fixed and accrual time-off budgets for a TalentHR employee. Budget amounts remain provider decimal strings. Results may include historical cycles; optionally select the active cycle or a specific cycle.
get_employee
Get a detailed TalentHR employee profile by an employee ID from list_employees. Includes personal details, job relationships, custom fields, and contact information available to the API key.
get_calendar
Get TalentHR employee absences and holidays for a date range. Results include pending and approved time off, and may include terminated employees. Use filter to narrow status or organizational groups. If endDate is omitted, TalentHR uses the end of the start month.
list_reference_data
Discover TalentHR countries, nationalities, relationship types, languages, or time-off types for employee profiles and leave workflows. Numeric IDs and provider-specific fields remain available for subsequent calls.