{"id":"a8f28e8d-333e-425b-8544-4f32c6f5948a","task":"Create and manage a company benefit (plan-level) in Gusto Embedded Payroll","domain":"gusto.com","steps":["List supported benefit types via GET /v1/benefits to get the canonical benefit_type enum values and whether each type supports employee and employer contributions.","Create a new company benefit plan using POST /v1/companies/{company_id}/company_benefits with the benefit_type, description, active flag, and whether the plan is employee-deductible.","Optionally set employer contribution defaults at the plan level; individual employee overrides are set at the employee_benefit level.","Activate or deactivate the plan by sending a PUT to /v1/companies/{company_id}/company_benefits/{company_benefit_id} with active set to true or false.","Retrieve the updated plan to confirm settings, then proceed to enroll individual employees."],"gotchas":["The benefit_type field uses a fixed enum; submitting an unrecognized type returns a 422 — always fetch /v1/benefits first to get valid values for the current API version.","Deleting a company benefit is not supported once employees are enrolled; you can only deactivate it, which stops future deductions but does not reverse prior ones.","Company benefits tied to carrier integrations (fully-insured medical) may require additional carrier setup outside the API before the benefit appears on pay stubs."],"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/a8f28e8d-333e-425b-8544-4f32c6f5948a"}