--- title: HeavenHR API Integration on Truto slug: heavenhr category: HRIS canonical: "https://truto.one/integrations/detail/heavenhr/" --- # HeavenHR API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Companies** — Companies represent the companies in HRIS - **Employees** — Represents an employee in HRIS - **Groups** — Groups represent the groups for an Employee - **Locations** — Locations represent the locations in HRIS - **Timeoff Requests** — Represent the time off requests for an Employee ## How it works 1. **Link your customer's HeavenHR 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 HeavenHR.** The Proxy API is a 1-to-1 mapping of the HeavenHR 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 - **Automate employee provisioning from HeavenHR** — SaaS companies building IT, security, or productivity tools can sync the HeavenHR employee roster to automatically create and deactivate user accounts, eliminating manual onboarding and offboarding for their European customers. - **Sync time-off data to power workforce planning** — Workspace management, scheduling, and resource planning tools can pull absence and leave request data from HeavenHR to accurately reflect team availability without requiring end users to update multiple systems. - **Build org-chart-aware features using groups and reporting lines** — Performance management, engagement, and approval workflow tools need accurate organizational structures. Integrating with HeavenHR lets them auto-build department hierarchies and manager relationships from the source of truth. - **Unlock the European SME market with a native HRIS integration** — HeavenHR is widely adopted across the DACH region and broader Europe. Offering a native integration gives SaaS companies a concrete way to win deals with European SMEs who rely on HeavenHR as their core HR system. - **Push new hire data into HeavenHR from upstream systems** — ATS and onboarding platforms can write employee records back to HeavenHR when a candidate is hired, eliminating double data entry and ensuring the digital personnel file is created instantly. ## What you can build - **Automated user lifecycle management** — Detect new hires, role changes, and terminations in HeavenHR to automatically provision, update, or revoke access in your product based on employee status and start/end dates. - **Out-of-office-aware scheduling** — Pull timeoff requests from HeavenHR to automatically mark employees as unavailable in your scheduling, desk booking, or resource planning tool. - **Real-time org chart sync** — Ingest employees, groups, and locations to dynamically build and maintain organizational hierarchies inside your product without manual CSV imports. - **One-click new hire push from ATS to HeavenHR** — When a candidate accepts an offer, automatically create their employee record in HeavenHR with demographic data, contact info, and custom attributes. - **Location-based policy enforcement** — Use HeavenHR location data to apply geography-specific rules in your product, such as assigning regional compliance training or provisioning locale-appropriate software licenses. - **Employee directory with self-updating profiles** — Sync employee profiles from HeavenHR so your product always reflects current names, titles, departments, and contact details without any manual upkeep. ## FAQs ### What authentication methods does the HeavenHR integration support? HeavenHR's API supports OAuth 2.0 and API key authentication. Truto handles the auth flow so your end users can connect their HeavenHR accounts without you managing tokens or key rotation. ### Which Unified HRIS API resources map to HeavenHR? Truto's Unified HRIS API maps Companies, Employees, Groups, Locations, and Timeoff Requests to HeavenHR's corresponding API endpoints, giving you a standardized schema across all HRIS integrations. ### Does the integration support write operations or is it read-only? HeavenHR's API supports CRUD operations on employees, including creating new hires and updating records. It also supports updating the status of timeoff and time-tracking requests. Specific write support through Truto's Unified API can be configured on request. ### Can I access custom fields from HeavenHR employee records? Yes. HeavenHR's API exposes custom attributes on employee profiles. Truto can map these into the Unified HRIS API so you can read and write custom data fields alongside standard employee properties. ### Are there tools or proxy endpoints available today for HeavenHR? HeavenHR tools and proxy endpoints are built on request. The Unified HRIS API resources (Companies, Employees, Groups, Locations, Timeoff Requests) are available. Contact Truto to scope any additional endpoints or custom workflows you need. ### How does Truto handle pagination and rate limits for HeavenHR? Truto manages pagination and rate-limit handling automatically behind the Unified API layer. Your application makes simple API calls and Truto handles retries, cursor management, and throttling so you don't need to build API-specific logic.