Tools

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