Enroll an employee in company-sponsored benefits via the Gusto Benefits API

Steps

1. Retrieve the list of company benefit plans offered by the company using the GET /v1/companies/{company_id}/company_benefits endpoint to identify available benefit types and IDs.
2. For each desired benefit, fetch employee-level eligibility and contribution details via GET /v1/employees/{employee_id}/employee_benefits.
3. Create or update an employee benefit enrollment by sending a PUT or POST to /v1/employees/{employee_id}/employee_benefits with the company_benefit_id, active flag, and employee/employer contribution amounts or percentages.
4. Confirm the enrollment is active by re-fetching the employee benefits and verifying the active field is true and contribution amounts match.
5. If the benefit is medical/dental/vision, check that the coverage start date aligns with the employee's hire date or qualifying life event date to avoid retroactive coverage gaps.