--- title: Humaans API Integration on Truto slug: humaans category: HRIS canonical: "https://truto.one/integrations/detail/humaans/" --- # Humaans API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employee Compensations** — Represent the compensation configuration for an Employee - **Employees** — Represents an employee in HRIS - **Employments** — Employments represent a job position at a company. - **Timeoff Requests** — Represent the time off requests for an Employee - **Timeoff Types** — Represent the time off types in a company ### Unified User Directory API - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Humaans account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Humaans.** The Proxy API is a 1-to-1 mapping of the Humaans API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync org structures into your performance management platform** — Automatically pull employees, reporting lines, and department mappings from Humaans so your customers never have to manually rebuild their org chart. When promotions or manager changes happen in Humaans, your tool stays in sync without any HR intervention. - **Automate IT provisioning and deprovisioning based on employee lifecycle** — Read employee and employment data from Humaans to trigger access provisioning for new hires and immediate revocation when someone is offboarded. SaaS companies building device management or identity governance tools can offer this as a turnkey integration for their customers using Humaans. - **Power real-time capacity planning with time-off data** — Resource planning and workforce scheduling tools can sync approved time-off requests and leave types from Humaans to automatically adjust availability and billable hours, eliminating the manual cross-referencing that slows down project managers. - **Drive dynamic compensation-based workflows** — Expense management, payroll, or financial planning SaaS products can read employee compensation data from Humaans to set spending limits, pro-rate payroll runs, or trigger budget alerts — all without requiring HR teams to export spreadsheets. - **Build a unified employee directory for collaboration tools** — Sync user directory data from Humaans into your communication, scheduling, or collaboration platform so end users always see accurate employee profiles, contact details, and team memberships without manual imports. ## What you can build - **Automated org chart sync** — Pull employees, managers, and department hierarchies from Humaans via the Unified HRIS API to keep your product's organizational structure always up to date. - **Real-time leave availability dashboard** — Sync time-off requests and time-off types from Humaans to display employee availability directly inside your scheduling or project management tool. - **Compensation-aware access controls** — Read employee compensation data to dynamically set tier-based permissions, spending limits, or approval thresholds inside your product. - **One-click employee onboarding trigger** — Detect new employees and employment records in Humaans to automatically kick off onboarding workflows like software provisioning, welcome emails, or equipment ordering. - **Offboarding automation from employment status changes** — Monitor employment data for termination dates or status changes and trigger downstream deprovisioning actions like license revocation and asset retrieval workflows. - **Cross-platform user directory search** — Use the Unified User Directory API to let your end users search and browse their Humaans employee directory natively within your product's interface. ## FAQs ### What authentication method does the Humaans integration use? Humaans supports OAuth and token-based authentication. Truto handles the full auth flow for you, so your end users can securely connect their Humaans accounts without you managing tokens or refresh logic. ### Which Unified APIs are available for Humaans through Truto? Humaans is supported through the Unified HRIS API (covering Employees, Employments, Employee Compensations, Timeoff Requests, and Timeoff Types) and the Unified User Directory API (covering Users). ### Does Truto handle pagination and rate limits for the Humaans API? Yes. Truto manages API-specific pagination and rate limiting automatically, so you can fetch complete datasets without writing custom logic to handle these concerns. ### Can I access custom fields from Humaans through Truto? Truto's unified API models map to standard fields. For Humaans-specific or custom fields, Truto supports passthrough requests that let you access the underlying Humaans API directly when needed. ### Are there pre-built tools for Humaans, or is it built on request? Humaans currently has no pre-built tools in Truto's catalog. However, tools are built on request — reach out to the Truto team and they can quickly add support for specific Humaans endpoints or workflows you need. ### Does Humaans support webhooks for real-time data sync? Yes, Humaans natively supports webhooks for events like employee creation and compensation changes. This allows your integration to react to changes in real time rather than relying solely on polling.