Create or confirm a Health FSA or Dependent Care FSA company benefit plan via /v1/companies/{company_id}/company_benefits with the appropriate benefit_type.
During open enrollment or a qualifying life event, enroll the employee via POST or PUT to /v1/employees/{employee_id}/employee_benefits with the annual election amount.
Convert the annual election to a per-period deduction amount based on the employee's pay frequency; some API implementations accept the per-period amount directly.
Confirm the effective date aligns with the plan year start or the qualifying life event date.
Verify the deduction is pre-tax on the payroll preview before finalizing.
Known gotchas
IRS annual FSA contribution limits for health FSAs and dependent care FSAs are separate and change each year — always validate against current-year limits.
FSA elections are generally irrevocable mid-year except for qualifying life events; the API will accept mid-year changes regardless, so process-level controls must enforce this restriction.
Dependent Care FSA has an additional limit equal to the lower of the employee's or spouse's earned income, which the API cannot validate without external income data.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp