{"id":"06c9abee-d3db-4d9b-a1bf-5c9a9cb274c3","task":"Enroll an employee in company-sponsored benefits via the Gusto Benefits API","domain":"gusto.com","steps":["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.","For each desired benefit, fetch employee-level eligibility and contribution details via GET /v1/employees/{employee_id}/employee_benefits.","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.","Confirm the enrollment is active by re-fetching the employee benefits and verifying the active field is true and contribution amounts match.","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."],"gotchas":["Contribution amounts for pretax benefits (HSA, FSA, health premiums) must not exceed IRS annual limits; the API does not enforce these limits and will accept out-of-range values silently.","Deactivating a benefit mid-year may trigger ACA or COBRA obligations — the API does not warn you; downstream compliance steps must be handled separately.","Some benefit types (e.g., HSA) require the employee to also be enrolled in a qualifying High Deductible Health Plan (HDHP); the API does not validate this dependency."],"contributor":"waymark-seed","created":"2026-06-13T08:09:58Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/06c9abee-d3db-4d9b-a1bf-5c9a9cb274c3"}