--- title: PrimePay HR API Integration on Truto slug: primepayhr category: HRIS canonical: "https://truto.one/integrations/detail/primepayhr/" --- # PrimePay HR API Integration on Truto **Category:** HRIS **Status:** Beta ## Unified APIs ### Unified HRIS API - **Employees** — Represents an employee in HRIS ## How it works 1. **Link your customer's PrimePay HR 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 PrimePay HR.** The Proxy API is a 1-to-1 mapping of the PrimePay HR 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 PrimePay HR** — SaaS platforms can read PrimePay's employee roster to automatically create, update, and deactivate user accounts based on employment status changes — eliminating manual onboarding and reducing security risk from stale accounts. - **Sync org structure for approval routing** — Expense management, procurement, and workflow tools can pull PrimePay's position-based org chart data to dynamically route approvals to the correct manager, even when reporting lines change mid-cycle. - **Trigger lifecycle workflows on hire, termination, and role changes** — By polling PrimePay for employment status and role updates, SaaS companies can fire downstream actions — like shipping hardware, assigning training, or revoking software access — without any manual HR intervention. - **Enrich your product with accurate employee demographics** — Identity verification, compliance, and benefits platforms can pull employee contact info, job titles, departments, and locations from PrimePay to pre-populate forms and reduce friction for end users. - **Power compensation and financial wellness features** — Financial planning, benchmarking, and earned wage access tools can read compensation data like salary, hourly rate, and pay frequency from PrimePay to deliver personalized insights without asking employees to self-report. ## What you can build - **Real-time employee directory sync** — Automatically mirror PrimePay's employee roster — including name, email, department, location, and job title — into your application on a scheduled or on-demand basis. - **Automated offboarding lockout** — Detect terminated or inactive employees in PrimePay and immediately revoke their access in your platform, helping mutual customers meet SOC 2 compliance requirements. - **Dynamic manager hierarchy mapping** — Leverage PrimePay's position-based org chart to build accurate, self-updating approval chains and reporting structures inside your product. - **New hire auto-enrollment workflows** — Trigger onboarding sequences — such as training assignment, equipment provisioning, or compliance form pre-fill — the moment a new employee record appears in PrimePay. - **Department and location-based access policies** — Read department and work location fields from PrimePay to automatically assign role-based permissions, cost centers, or regional configurations in your application. - **Compensation data feed for financial tools** — Pull salary, hourly rate, and pay frequency into your platform to power earned wage calculations, compensation benchmarking, or budgeting dashboards. ## FAQs ### What authentication method does PrimePay HR use? PrimePay HR exposes a modern OAuth 2.0 API. Truto handles the full OAuth flow — token exchange, refresh, and secure credential storage — so your team never manages auth directly. ### What data can I access through the Unified HRIS API for PrimePay? Through Truto's Unified HRIS API (Employees), you can access employee demographics (name, email, phone, date of birth), employment status and lifecycle dates, job title, department, location, manager relationships, and compensation fields like salary, hourly rate, and pay frequency. ### Is the PrimePay HR integration available out of the box? PrimePay HR is supported through Truto's Unified HRIS API for employee data. Specific proxy tools and additional resources are built on request — reach out to the Truto team to scope your exact requirements and timeline. ### How does PrimePay's position-based data model affect the integration? PrimePay uses a position-based architecture where the organizational 'seat' exists independently of the person in it. This means org chart data, reporting lines, and department assignments are unusually clean and stable compared to traditional employee-centric HRIS systems, resulting in highly reliable syncs. ### How fresh is the employee data from PrimePay? Data freshness depends on your sync configuration. Truto supports scheduled polling (hourly or daily) against PrimePay's API. PrimePay's 'Time Machine' architecture also means future-dated transactions won't overwrite current data, so your sync always reflects the accurate present state. ### Do I need to handle pagination or rate limiting myself? No. Truto manages pagination, rate limiting, retries, and API-specific quirks for PrimePay behind the scenes. You interact with a single, consistent Unified API regardless of how PrimePay's native API behaves.