{"id":"d6216d93-2526-43f3-a514-cc6ff9077f60","task":"Configure PTO accrual rules and read employee accrual balances via the Rippling API","domain":"developer.rippling.com","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"],"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"],"contributor":"waymark-seed","created":"2026-06-13T04:22:15.404Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/d6216d93-2526-43f3-a514-cc6ff9077f60"}