--- title: greytHR API Integration on Truto slug: greythr category: HRIS canonical: "https://truto.one/integrations/detail/greythr/" --- # greytHR 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 - **Groups** — Groups represent the groups for an Employee ## How it works 1. **Link your customer's greytHR 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 greytHR.** The Proxy API is a 1-to-1 mapping of the greytHR 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 employee rosters for corporate spend management** — Expense and spend management platforms can pull employee data, org hierarchy, and compensation bands from greytHR to auto-provision corporate cards, set spending limits, and route approvals to the correct managers — without any manual CSV uploads from HR teams. - **Automate IT provisioning and offboarding from HRIS events** — IT asset management and identity platforms can monitor greytHR for new hires, role changes, and terminations to automatically provision software licenses, ship hardware, or trigger access revocation — keeping IT in lockstep with HR without manual tickets. - **Power earned wage access with real-time compensation data** — Financial wellness and EWA platforms need accurate salary structures and employment status from greytHR to calculate accrued wages and offer mid-cycle payouts, ensuring reconciliation with the employer's actual payroll run. - **Drive zero-touch benefits enrollment from HR data** — Insurtech and benefits administration platforms can sync employee demographics, department, and compensation tier from greytHR to automatically enroll new hires in the correct insurance plan and upgrade coverage when employees are promoted — eliminating manual data entry for HR. ## What you can build - **Real-time employee directory sync** — Automatically import and keep up-to-date the full employee roster from greytHR — including personal details, job titles, employment status, and reporting managers — using Truto's Unified HRIS API Employees resource. - **Org chart and department mapping** — Replicate greytHR's department taxonomy and team structures in your product using the Groups resource so you can mirror approval chains, cost-center assignments, and access policies. - **Compensation-based policy engine** — Fetch salary structures and pay bands from the Employee Compensations resource to dynamically assign credit limits, insurance tiers, or benefit eligibility based on each employee's actual compensation data. - **Automated lifecycle triggers on employment status changes** — Detect when an employee's status changes to hired, resigned, or terminated in greytHR and fire downstream workflows like onboarding sequences, access revocation, or asset recovery in your product. - **One-click greytHR connection for your end users** — Let your customers securely connect their greytHR account through Truto's managed OAuth 2.0 flow — no API key wrangling or IT support tickets required. ## FAQs ### What authentication method does greytHR use? greytHR uses OAuth 2.0 for API authentication. Truto manages the full OAuth flow, including token refresh, so your end users can connect their greytHR account securely without you handling credentials. ### Which Unified API resources are available for greytHR? greytHR is supported through Truto's Unified HRIS API, which currently covers Employees, Employee Compensations, and Groups. These let you read employee profiles, salary structures, and organizational hierarchy. ### Are there greytHR-specific tools or custom endpoints available? There are no pre-built greytHR-specific tools at the moment. However, Truto builds custom tools on request, so if you need access to data beyond the Unified HRIS API resources — such as attendance logs or leave balances — you can request them. ### Does Truto handle pagination and rate limits for greytHR? Yes. Truto abstracts away pagination and rate-limit handling for greytHR's REST API, so you get a consistent interface regardless of greytHR's underlying API behavior. ### What kind of companies typically connect greytHR through an integration? greytHR is popular with SMEs (50–500+ employees) in India, the Middle East, and Southeast Asia, particularly in IT, SaaS, manufacturing, healthcare, and retail. If your product serves these markets, offering a greytHR integration covers a significant share of your users' HRIS landscape. ### Can I write data back to greytHR through Truto? The Unified HRIS API supports read operations for Employees, Employee Compensations, and Groups on greytHR. If you need write capabilities for specific use cases, contact Truto to discuss building custom tools for your workflow.