--- title: ClayHR API Integration on Truto slug: clayhr category: HRIS canonical: "https://truto.one/integrations/detail/clayhr/" --- # ClayHR API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employees** — Represents an employee in HRIS - **Groups** — Groups represent the groups for an Employee ## How it works 1. **Link your customer's ClayHR 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 ClayHR.** The Proxy API is a 1-to-1 mapping of the ClayHR 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 and deprovisioning** — IT and identity management SaaS platforms can sync employee records from ClayHR to automatically provision accounts, devices, and app access for new hires — and revoke everything instantly on termination. This is especially critical for ClayHR's government and public sector customers with strict security requirements. - **Sync org structure for approval routing** — Expense management, procurement, and time-tracking platforms can pull department hierarchies and manager mappings from ClayHR to automatically route approvals to the correct people without manual configuration by the end user's HR team. - **Drive targeted employee engagement programs** — Employee engagement and survey platforms can import the full company directory with group and department data from ClayHR to launch targeted pulse surveys, segment analytics by team, and facilitate peer reviews using accurate reporting relationships. - **Automate compliance and training assignments** — Learning management platforms can sync employee titles, departments, and group memberships from ClayHR to auto-assign role-specific mandatory training — a high-value workflow for ClayHR's education and government clients where compliance tracking is non-negotiable. - **Keep payroll and benefits platforms in sync** — Payroll and benefits SaaS products can read employee profiles, compensation data, and group assignments from ClayHR to ensure accurate payroll runs and benefits enrollment without manual CSV imports. ## What you can build - **Real-time employee directory sync** — Automatically import and keep up-to-date the full ClayHR employee directory — including names, emails, job titles, start dates, employment status, and manager relationships — using the Unified HRIS Employees API. - **Department and team hierarchy mapping** — Pull departments, teams, locations, and their parent-child relationships from ClayHR via the Unified HRIS Groups API to reconstruct the org chart natively in your product. - **Onboarding and offboarding event detection** — Poll for employee status changes in ClayHR to trigger automated downstream workflows — like provisioning a laptop when status changes to Hired or locking SSO access on Terminated. - **Manager-based approval chains** — Use manager associations from ClayHR employee records combined with group data to automatically build multi-level approval workflows without any manual setup from end users. - **Group-based access and policy rules** — Assign spending limits, feature permissions, or security policies in your product based on which ClayHR group or department an employee belongs to, updated automatically on every sync. - **Custom field passthrough for specialized data** — Surface ClayHR's heavily-used custom fields — like security clearance levels or safety certifications — in your product by mapping them through Truto's unified data model. ## FAQs ### What Unified APIs does Truto support for ClayHR? Truto supports ClayHR through the Unified HRIS API, which covers Employees and Groups resources. This lets you read employee profiles, manager relationships, departments, teams, and organizational hierarchies through a standardized schema. ### Are there pre-built tools available for ClayHR on Truto? ClayHR does not have pre-built tools yet — they are built on request. If you need specific API operations beyond what the Unified HRIS API provides, reach out to Truto and they will build them for your use case. ### How does authentication work for ClayHR integrations? Truto handles the full authentication flow with ClayHR on your behalf. Your end users connect their ClayHR accounts through Truto's embedded linking experience, so you never have to manage tokens, credentials, or renewal logic directly. ### Can I access ClayHR custom fields through Truto? ClayHR customers rely heavily on custom data tables and fields. Truto's Unified HRIS API supports mapping custom fields, so you can surface data like security clearance levels, certification statuses, or other organization-specific attributes alongside standard employee and group data. ### Does Truto handle pagination and rate limits for ClayHR's API? Yes. Truto abstracts away pagination and rate-limit management for ClayHR's API. You make standard requests to Truto's Unified API and it handles the underlying complexity of fetching complete datasets without hitting ClayHR's rate limits. ### What kind of data can I read from ClayHR employees? Through the Unified HRIS Employees API, you can read core employee profile data including name, email, job title, start date, employment status, and manager associations. This covers the most common needs for provisioning, directory sync, and org chart construction.