Configure PTO accrual rules and read employee accrual balances via the Rippling API
domain: developer.rippling.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate to the Rippling API using OAuth with HR admin scope
GET /time_off/policies to list existing PTO policies and their accrual configurations (accrual rate, accrual frequency, carryover cap)
POST /time_off/policies to create a new policy with custom accrual rules, specifying accrual_type (hourly, per-period, anniversary), rate, and cap values
GET /time_off/balances?employee_id={id} to retrieve the current accrued, used, and available balance for a specific employee
POST /time_off/adjustments to apply a manual accrual correction or carryover balance adjustment for an employee when needed
Known gotchas
Rippling enforces accrual policy changes prospectively; retroactive adjustments to past accruals require manual balance corrections rather than policy edits
State-mandated PTO accrual laws (e.g., California, Colorado) impose minimum accrual rates and payout-on-termination requirements that override custom policy settings; validate compliance before deploying custom rules
The API does not expose real-time accrual simulation; balances reflect the last nightly accrual run rather than the precise current moment
Give your agent this knowledge — and 15,600+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?