--- title: Paylocity API Integration on Truto slug: paylocity category: HRIS canonical: "https://truto.one/integrations/detail/paylocity/" --- # Paylocity API Integration on Truto **Category:** HRIS **Status:** Beta ## How it works 1. **Link your customer's Paylocity 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 Paylocity.** The Proxy API is a 1-to-1 mapping of the Paylocity 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 to automate user provisioning** — SaaS companies pull employee demographics, job titles, departments, and reporting structures from Paylocity to automatically provision user accounts and map approval hierarchies—eliminating manual CSV uploads for their mid-market customers. - **Push reimbursements and bonuses directly into payroll** — Expense management, commission, and recognition platforms use Paylocity's Pay Entry API to inject one-time payments into an upcoming payroll batch, so employees get paid on their next check without HR manually keying amounts. - **Automate benefits deduction updates from enrollment changes** — Benefits administration and retirement SaaS platforms write updated deduction amounts back to Paylocity whenever an employee changes their elections, keeping payroll in sync without manual intervention from payroll managers. - **React to employee lifecycle events in real time** — IT provisioning, learning, and compliance platforms listen for Paylocity webhooks on hire, termination, and transfer events to trigger downstream workflows like access revocation or onboarding task creation the moment a status changes. - **Import time and attendance data for payroll processing** — Shift-scheduling, POS, and workforce management tools push aggregated clock-in/clock-out data into Paylocity so payroll runs include accurate hours without dual data entry across systems. ## What you can build - **One-click employee directory sync** — Pull the full Paylocity employee roster—including department, manager, compensation, and custom fields—into your product to auto-provision users and build org charts. - **Payroll batch injection for reimbursements** — Push approved expense reimbursements, spot bonuses, or commission payouts directly into Paylocity's current payroll batch so employees are paid on their next check. - **Automated deduction management** — Create, update, or remove recurring paycheck deductions in Paylocity when employees change benefit elections or retirement deferral percentages in your app. - **Real-time termination and hire triggers** — Subscribe to Paylocity's employee status change webhooks to instantly kick off workflows like revoking SaaS licenses on termination or shipping hardware on hire. - **New hire push from ATS to Paylocity** — When a candidate is marked as hired, automatically create their employee record in Paylocity with name, address, salary, and start date—bypassing manual data entry. - **Post-payroll data pull for financial reconciliation** — Listen for the Payroll Processed webhook and retrieve finalized pay statement details to reconcile 401k contributions, tax withholdings, or GL entries in your finance product. ## FAQs ### What authentication method does Paylocity's API use? Paylocity uses OAuth 2.0 with a client credentials flow. Your end users authorize access through Paylocity's partner onboarding process, and Truto handles token acquisition and refresh so you don't manage credentials directly. ### Does Paylocity support webhooks for real-time event notifications? Yes. Paylocity offers webhooks for key events including Payroll Processed and Employee Status Changes (hired, terminated, transferred). These allow your application to react immediately rather than polling for updates. ### What data can I read from Paylocity's employee endpoints? You can retrieve demographics, job titles, departments, manager IDs, compensation details, tax setup information, and employment status for all employees or by individual employee ID. ### Can I write data back to Paylocity, or is it read-only? Paylocity supports both read and write operations. You can create new employee records, add or update paycheck deductions, push earnings into payroll batches via the Pay Entry API, and import time punch data. ### Is a Truto Unified API available for Paylocity today? Paylocity is not yet mapped to a Truto Unified API but is available as a build-on-request integration. Truto will handle auth, pagination, and API-specific quirks so you get a clean, consistent interface. Reach out to discuss your specific data requirements. ### What Paylocity customer segment will this integration serve? Paylocity's core market is U.S. mid-market companies with 50 to 2,500+ employees across industries like healthcare, education, retail, and manufacturing. If your customers fall in this range, Paylocity is likely in their HR stack.